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USER'S MANUAL STATEMENT 

"This equipment generates and uses radio frequency energy and if not 
installed and used properly, that is, in strict accordance with the 
manufacturer's instructions, may cause interference to radio end 
television reception. It has been type tested and Found to comply with 
the limits for a Class 8 computing device in accordance with the 
specifications in Subpart J of Part 15 of FCC rules, which are designed 
to provide reasonable protection against such interference in a 
residential installation. However, there is no guarantee that 
interference will not occur in a particular installation. If this equipment 
does cause interference to radio or television reception, which can be 
determined by turning the equipment off and on, the user is 
encouraged to try to correct the interference by one or more of the 
following measures: 

— reorient the receiving antenna 

— relocate the computer with respect to the receiver 

— move the computer away from the receiver 

— plug the computer into a different outlet so that computer and 
receiver are on different branch circuits. 

"If necessary, the user should consult the dealer or an experienced 
radio/television technician for additional suggestions. The user may 
find the following booklet prepared by the Federal Communications 
Commission helpful: 'How to Identify and Resolve Radio-TV 
Interference Problems.' This booklet is available from the U.S. 
Government Printing Office, Washington, D.C. 20402, Stock No. 
004-000-0O345-4, , • 
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production, the COMMODORE 64 allows you to connect your aud ; o out- 
put to almas* any high-quality amplification system. 

While we're on the subject of connecting t'-ie COMMODORE 64 to 

other cvieees of equipment . . . your system can be expanded by adding 
accessories, known a5 peripherals, as your corripu'iriy needs yrow. 

Some of your options irclude items like a DAI AiiSErTE* recorde- or as 
many as 5,. VIC 1541 disk drive storage units for the programs you make 
and/or play. If you already have a VIC 1540 disk drive your dealer can 
update t -or use with the COMMODORE 64. You con add a VIC dot 
matrix printer to give you printed copies of your programs, letters, in- 
voices, etc. . . if you wait to connect up with larger computers and their 
massive data bases then just plug in a VICMODEM cartridge, and get 
the services of hundreds of specialists end a variety of information net 
works through your home or business telephone. Finally if you're one of 
those people interested in, the wide variety of applications software 
available In CP/M** , *he COMMODORE 64 can befitted with a plug-in 
Z-80 microprocessor. 

Just os important as all the available hardware is the fact that this 
USER'S GUIDE will he p you develop your understanding of computers. 
It won't *ell you everything there is to know about computers, but it will 
refer you to a wide variety of publications for more detailed information 
about the topics presented. Commodore wants you to really enjoy your 
new COMMODORE 64. And to have fun, remember: programming is 
not the kind of thing you can lean in a day. Be patient with yourself as 
you go through the USER'S GUIDE. But before you start, take a few 
minutes "o fill out and mail in the owner/ registration card that crime with 
your computer. It will ensure that ycur COMMODORE 64 is properly 
registered with Commodore Headquarters and that you receive the most 
up-to-date Information regarding *uture enhancements for your ma- 
chine. Welcome to a whole new world of fun!! 

NOTE: 

Many programs are under development while this mam in I is being 
produced. Please check with your local Commodore dealer and with 
Commodore User's Magazines ano Clubs, which will keep you up to 
date on the wealth of applications programs being writter for the 
Commodore A4, worldwide. 



"DATAS5:TTE Is a registered trademark of Ccmmodore Business Machines, Inc. 
** CPM1 It o regisTered iraderrork of Digital Research In:. Specifications subject to 
change. 



viii 



INTRODUCTION 

Congratulations, on your purchase of one of the best computers in the 
world. You are row the proud owner of the COMMODORE 64. Com- 
modore is known as The Friendly Computer company, and port of 
being friendly is giving you easy to read, easy to use and easy to 
understand instruction manuals. The COMMODORE 64 USER'S GUIDE is 
designed tn give you all the information you need to properly set up your 
equipment, ge" acquainted with opercring the COMMODORE 64, and 
give you a simple, fun start a- learning to make your own programs. 

For those of you who don't want to bother learning how to program, 
we've put all the information you need to use Commodore programs o' 
other prepackaged programs and/or game cartridges (third party 
software) right up front. This means you don't have to hunt throjgh -he 
entire boo< to get started. 

Now let's look at some of the exciting features that are just waitirg for 
you inside your COMMODORE 64, First, when it comes to graphics 
you've cot the mosl advanced picture maker in the microcomputer in- 
dustry. We call it SPRITE GRAPHICS, and it allows you to design your 
own pictures in 4 different colors, just like the ones you see on arcade 
type video games. Not only that, the SPRITE EDITOR let's you animate as 
many as 8 different picture levels at one time. The SPRITE EDITOR will 

soon be available as a software program that you con load directly into 
your COMMODORE 64. You can move your creations anywhere on the 
screen, oven pass one image in front of nr behind another. Your COM- 
MODORE 64 even provides automatic collision detection which instruct; 
the computer to take the action you want when the sprites hit each 
other. 

Next, the COMMODORE 64 has built-in music and sound effects that 
rival many well known music synthesizers. Tl-ig part of your computer 
gives you 3 independent voices, each with a full 9 octave "piano-type" 
range. In addition you get 4 different waveforms (sawtooth, triangle, 
variable pulse, ond noise), a programmable ADSR (attack, decay, sus- 
tain, release) envelope generator and a programmable high, low, and 
bandpass filter for the voices, and variable resonance and volume con- 
trols. If you want your music to play back with professional sourd re- 



UNPACKING AND CONNECTING THE 
COMMODORE 64 

The following step-by-step instructions show you how to connect the 
Commodore 64 to your television set, sound syslem, or monitor and 
make sure everything is working properly. 

Before attaching anything to the computer, check the contents of the 
Commodore 64 container. Besides this manual, you should find the fol- 
lowing items: 

1 . Commodore 64 

2. Power supply (black box with an AC plug and supply cord) 

3. Video coble 

4. TV Switchbox (small silver box with short antenna leads). 

If any items are missing check back with your dealer mmed ately for 
a replacement. 

First, let's take a look ot the arrangement of the various connections 
on The compute' and how each functions. 

SIDE PANEL CONNECTIONS 

1. Power Socket. The free end of the cable from the power supply is 
attached here to supply power to the Commodore 64. 

2. Power Switch. Turns on power 'o the Commodore 64. 

3. Game Ports. Each game connector can accept a joystick or game 
controller paddle, white the lightpen can only be plugged into the 
game port closest to the front of your computer. 

REAR CONNECTIONS 

4. Cartridge Slot. The rectangular slot to the left accepts program or 
game cartridges. 

5. Channel Selector. Use this switch to select which TV channel the 
computer's picture will be displayed on. 

6. TV Connector, This connector supplies both the picture and sound to 

your television set. 

7. Audio & Video Output. This connector supplies direct audio, which 
can be connected to a high quality sound system, and a "compos- 
ite" video signal, which can be fed into a television "monitor." 

8. Serial Port. You can anach a printer or single disk drive directly to 
the Commodore 64 through this connector. 
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9. Cassette Interface. A DATASSETTE recorder can be attached to the 

computer go you can Gave informcitior entered Tor use at a leter 

time. 

10. User Port. Various interface cartridges can be attached to the user 
port, such as the VICMODEM, or RS 232 communication cartn rig p> 



INSTALLATION 

CONNECTIONS TO TOUR TV 



Connect the computer to your TV as shovun on page 4. 

1. Attach one and of the TV cable to the phono type TV signal jack at 
the rear of the Commodore 64. Just push it in. Either end of the 
cable can be used. 

2. Connect the other end of the cable to the antenna switchbox. Just 
push it in. 



TV 

SWITCH eon 




3. If you have a VHF antenna, disconnect it from /our TV set. 

4. Connect your VHF antenna cable to the screw terminals labeled "an- 
tenna input" on the switchbox, If your antenna cable is the round 
75 ohm coax type, use a 75-ohm to 300-ohm adapter (ngl supplied) 
to attach your antenna cable to the switchbox. 

5. Connect the twin lead output cable of the antenno switchbox to the 
VHF antenna terminals of your TV set. If your set is one of the newer 
types with a round 75 ohm VHF connector, you will need a 300-ohm 
to 75-ohrrt converter (not supplied) to connect The switchbox to the 
75-ohm VHF antenna input on the set. 

6. Set the TV's VHF tgner to the channel number indicated on "he com- 
puter's channel selector switch (channel 3 move the switch to the left; 
channel 4 move the switch to the right). If a strong Iccal TV signal is 
present on one of these chcnnels, select the other channel to avoid 
possible interference. 

8. Plug the power sjpply cable into the power socket on the side of the 
Commodore 64. Just push it in. It is "keyed" to allow nsertion in only 
one direction, so you can't cornect the power cord trie wrong way. 
The power supply converts household current into the form the com- 
puter uses. 
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The Commodore 64 is now correctly connected. No ndditionol con- 
nections are required to use the computer with your TV. The antenna 
svWichbox will connect the compuier re the TV when the slide switch is in 
the "computer" position, When the switch is )n the "TV" positior your set 
will operate normally. 
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OPTIONAL CONNECTIONS 



Since the Commadore 64 furnishes c chanrel of high fidelity sound, 
you nay wish to play it through a quality ampl'fisr to realize the best 
sound possible. In addition, the Coimrodore 64 clso provides a stan- 
dard "composite" video signal, which can be fed into a television 
monitor. 

These options are mode possble riy the mjrlin/vid^n output jark fin 

the rear panel of the Commodore 64. Trie easiest way to gain access to 
these signals is by using a standard 5-Pin DIN audio cable (rot 
suppfied). This cable connects directly to the audio/video connector on 
the csmputer. Two of the four pins on the opposite end of the cable 
contain the audio and video signals. Optionally, ycu can construct your 
own caule, us ng the pinouts shown in Appendix I as a guide. 



Normally, the BLACK connector of *he DIN cable supplies the AUDIO 
signal, This plug may be connected to the AUXILIARY input of an am- 
plifier, or the AUDIO IN connector of a monitor or cher video system, 
such os a video cassette recorder (VCR). 

The WHITE or RED connector usually supplies the direct VIDEO signal. 
This plug is connected to the VIDEO IM connector of the monitor or video 
input section of seme other video system, such as a VCR. 

Depending on the manufacturer nf your DIN cable, the color coding 
of the plugs Ticiy be different. Use the pinouts shown in Appendix I to 
match up the proper plugs if you don't ge* on audio or video sigral 
using the suggested CDnnections. 
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If ycu purchased peripheral equipment, such as o VIC 1541 disk drive 
or a VIC 1515 printer, you may wish to connect it at this time, Refsr to 
the users manuals supplied with any additional equipment for the 
proper procedure for connecting it to the computer. 



A completed system might look like this. 




OPERATION 



USING THE COMMODORE 64 



1 . Turn on rhe computer using the rocker switch on the right-side panel 
when you're looking at the computer from the front. 

2, After a few moments the following will be displayed on rhe TV 
screen: 




3. If your TV has a manual fine Tuning knob, adjust the TV until you get 
a clear picture. 

4. You rnay also want to adjust tne color and tint controls on the TV for 
the best display. You can use the color adjustmen- procedure dc 
scrbed later to get everything setup properly. When you first get a 
picture, the screen should appear mostly dark blue, with a light 
blue border and letters. 

If you don't get the expected results, rechsck the cables and connec- 
tions. The ciccortipanyirig chart will help you isolate any problem. 



TROUBLESHOOTING CHART 



Symptom 


Cause 


Remedy 


Indicator Light 


Computer rot 


Moke jure power 


not "On" 


"Oi" 


switch Fs in "On" 
position 




3 owcf cobls 


Cheek power socket 




not plugged 


for loos-e or dis- 




in 


connected p-Ow&r 

cable- 




Wer $ypply 


Check conne^tipn 




not plugged 

in 


with wall outlet 




Bad fuse in 


Take system to 




computer 


authorized dealer 
for replacement of 
fuse 




TV on wrong 


Check other 




channel 


channel for 
picture (3 or 4) 




Incorrect 


Computer hooks up to 




hookup 


VHF antenna terminals 




Video cable 


Check TV output 




not plugged 

■n 


cable connection 




Computer set 


Set cornpjter for 




for wrong 


same channel as TV 




channel 


(3 or A) 



Symptom 


Cause 


Rtmecfy 


Random pattern 


Cartridge not 


Reinsert 


on TV with 


properly 


ca'lridge after 


cartridge in 


inserted 


tunning off power 


place 

Picture wirhout 


Poorly tuned 




Retune TV 


color 


TV 




Pic+ur* with 


5-:id color 


Adjust esler/ 


poor cclor 


adjustment 


hue/brightnes* 




an TV 


■controls on TV 


Sound witti 


7V volume up 


Adfijjf volyme o*f 


excess 


hiyh 


TV 


background 






noise 






Picture OK, 


TV volume roo 


Adjust volume of 


but no sound 


low 


TV 




Aux. output 


Connect sound 




m-3-t properly 


pack to aux. input 




connected 


on amplifier and 
select nux, input 



TIP: The COMMODORE 64 was designed to be used by everyone. 
But we ot Conwodore recognize that computer users may, occasionally, tun into 
difficulties. To help answer your questions and give you some fun programmirg 
ideos, Com-nadore has created several publications tc help you. Toil might olso find 
that its a good idea to join a Commodore Users Club to help you meet some other 
COMMODORE 64 owners wrro can help you gem knowledge and experience. 



CURSOR 

The flashing squa-e under READY is called the cursor and indicates 
where what yog type on the <e/bocird will be displayed on the screen. 
As you type, the cursor will move ahead one space, as the original 
cu-sor position is replaced with the character you t/ped. Try typing on 
the keyboard and watch as characters you type are displayed on the TV 
screen. 
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COLOR ADJUSTMENT 



There is a simple way to get a pattern cf colors on the TV so you can 
easily adjust the set. Even though you may not be familiar with the 
operation of the computer right inw, just follow along, and you'l see 
how e^5y "rt is to use the Commodore 64. 

First, look on the left side of the keyboard and locate the key marked 
13T11 . This stand; for ConTRoL and is used, in conjunction with other 
keys, to instruct the computer to do o specific task. 
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To use a control funclion, you hold down the ^^3 key while dcprc.s 
ing a second key. 

Try this: held the^^S^ey while also depressing theQkey. Then -e- 
lease both keys. Notiing obvious shoLld hove hapsened, but H you 
tcuch any key now, the screen will show ihe chcracter displayed in re- 
verse type, rather thai normal type — like the opening message or any- 
thing you typed earlier. 

Hold down the ^ 2^E3 ■ What hoppens? If you did the above pro- 
cedure correctly, you should see a light blue bar move across the screen 
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and then move down to the next line as long os the J "*; ;;'r| is de- 
press, ed. 



«*** COMMODORE 64 BASIC V2 
64K Ip-flM SVSTEM 3891 1 BASIC R- 

REflDV 


r'TES FREE 






^^^M 





Now, hold y>;rB while depressing any of the other number keys. Each 
of them has a color marked or the front, Anything displayed from this 
point will be in that color. For example, hold ^^and the0key and 
release both. Now hold the EfflffiW -1 

Watch the display. The bar is now in yellow! In a like manner you can 
change ihe bar to any of the other colors inclcafed on the njmber keys 
by holding |g|yg and Ihe appropriate key. 

Change the ba- to a few mare different colors and then adjust the 

color and tint controls on your TV se the display motcies the colors you 
selected. 

Ihe display should appear something like this: 




At this point everything is properly adjj&ted and working coueclly. 
The following chapters will introduce you to the BASIC language. How- 
ever, you can immediately start using some of the many prewritten ap- 
plications and games available for the Commodore 64 without knowing 
anything about comouler programming. 

Each of these packages contains detailed information about how to 
jse the program. It is suggested, though, that yoL read through the first 
few chap+grs of this manual to become rnore familiar with the basic 
operation of your new system. 
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KEYBOARD 

Now that you've got everything set up and adjusted, please take a 
few moments to familiarize yourself with the keyboard which is your 
rnusl important means of communication with the Commodore 64, 

You will find the keyboard similar to a standard typewriter keyboard 
found in most areas. There are, however, a number of new keys which 

control specialized functions. What folows is a brief description of the 
various keys and how they function. The detailed operation of each key 

will be covered in late' sections. 




The ^^^^^ key signals the computer to look at the information that 
you typed and enters that information into memory. 



The E!IBI key works like tha" en a standard typewriter. Many keys 
are capable of displaying two letters or symbol* and two graphic char- 
acters. In the "upper/lower case" mode the J 1 "'4^§ key gives you stan- 
dard upper case characters. In the "upper case/graphic" mode the 
! iTliiJI k^Y W 'H display the graphic character on the right hand side of 
the front part of the key. 

In the case of special YELLOW function keys, the EI 3 ^ e / wi " 9 iv e 
you the function marked on the front of the key. 
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EDITING 

No one is perfect, and the Commodore 64 rakes that into account. A 
number of editing keys let you correct typing mistakes and move infor- 
mation around on the screen. 

Ifffll 

There are two keys marked | r ^| (CuRSoR), one with up and down 
arrows [jf rei; J) ,the other with left and right arrows f is Q . You can 
use these keys to move the cursor up and down or left and right. In the 
unshifted mode, the G233 keys will let you move the cursor down and to 
the rig ht . Using the |S'''iF<J key and ^^^J keys allows the cursor to be 
moved either up or to the left. The cursor keys hove a special repeat 
feature that keeps the cursor moving untii you release the key. 



If yon hit the I ' » ' 'J key, the cursor will move back a space, eras- 
ing (DELeting) the previous character you typed. If you're in the miedle 
of a line, the character to the left is deleted and the characters to the 
right automatically move together to close up the space. 

A 'QiQed ^^-v-*n allows you to INSerT information on a line. For 

example, if you noticed a typing mistake in the beginning of a line — 
perhaps you left out parr of a name — you could use the ^ :;ft -^ key to 

move back to the er'or and then hit | i I ) to insert a space. Then 

just |type in the missing letter. 

\MSM 

QJ2H3 positions the cursor at the "HOME" postion of the screen, 
which is the upper left-hard corner, A shifted HTH!Hni3 will clear the 
screen and place the cursor in the home position. 



operates as the name implies. It restores the computer to the 
normal state it was in before you changed things with a program or 
some command. A lot more will be soid on thi= in later chapters. 
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FUNCTION KEYS 

The four fundion keys on the right side of the keyboard can be "pro- 
grammed" to handle a variety of functions. They can be defined in 
many ways tc handle repetitive tasks. 



an uo na bb 






The§Jjyjkey, which stands fo' ConTRoL, allows you -o set colors, and 
perform other specialized functions. You hold the [ J key down while 
depressing another designated key to get a control function. You had an 
opportunity to try theB :Hkey when you changed text colors to create 
different color bars curing the setup procedure. 
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Normally, depressing the ^^^^^y k-ey will stop J he execution of a 
BASIC program. It signals the computer to STOP doing something. Using 



the L ; I key in the shifted mode will allow you to automatically 
oad a program from tape. 

3 COMMODORE KEY 

The Commodore key Q performs a number of functions. First, it 
allows you to move between the text and graphic display modes. 

When the computer is first turned on, it is in the Upper Case/Graphic 
mod*, that is, everything you type is in upper ccse letters. As was men- 
tioned, using ihe (« ! ] key In this mode will display the graphic on the 
right side of the keys. 

If you hold dawn the Q key and BTIB1 key, the display will change 
to upper and lower cose. Now. i* you hold down the [9 <:ey end any 
other key with a graphic symbol, the grcphic shown on the left side of 
the key will be displayed. 

To get back into the upper cose/graphic mode hold down tie Q <ey 
nnd E "1 key rignin. 

The cccord function of the [a key is to allow you access to a second 
set of eiglr text coors. By holding down the [^ key and any of the 
number keys, ary text now typed will be in the alternate color ava lable 
from the key ycu depressed. Chapter 5 lists the text colors avolable 
"ram each key. 



BACK TO NORMAL 

Now that you've had a charce to look ever the keyboard, let's explore 
some of the Commodore 6A's many capabilities. 

f yoj still have the color bars on the screen from adjusting your TV 
set, hold [j^Q and (jjjJUJjmj . Ihe screen should clear and the cursor 
will be positioned in the "nome" spot (upper left-hand corner of the 
screen) 

Now, simultaneously hold [*3 and tne ^| key. This seta the text color 
r>ack to light blue. There is one more step needed to get everything back 
to norma I. Hold EGJ end Q (Zero not Oh 11. This sets the display mode 
back to norrnnl. If you remember, we turned RFVERSE type an with the 
9 to create the color bars (the color bars were actually reversed 
spaces). If we were in the normal text mode during the eclor test, the 
cursor would have moved, but just left blank spaces. 
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Now that youVe done things the hard way, there is a simple woy to reset the 

machine to the norinal display. First press the i:i' :rttfu key und then press 
the 1-IjjiMTI <:i-y. I'j'tfmI'IJ must always be held dawn in order to use the 
^^^3 tR V funrlinn. 

"His will clctfn* the screen and rfltym everything to normal. If llien? is u pruyum in 
the cormpjter, rt will i« left untouched. This is a good ieqjerte to reintfinbur , espt?- 
Liutly if yju do u lol of proyrumminy. 

If you .vkh "o reset "he marnine r:s if iT ■.'..•■ere 'irieo off uric men switched on 
again, type, .y*5c4759 anil press E3QS ■ Se caret jl using -his command. Ifwil 
wips cut an/ program or information that is currently in the computer. 



LOADING AND SAVING PROGRAMS 

One of the most important features o" the Commodoro 64 is the ability 
to save and load programs to end from cassette: taoe or disk. 

This capability allows you ro save The programs you write for use at a 
later time, or purchase prewritten programs to use w'th the Commodore 
64. 

Moke sure that either the disk drive or datasette unit is attached 
properly. 

LOADING PREPACKAGED PROGRAMS 

For those of yoj interested in using only prepackaged programs 
available on cartridges, cassette, or disk here's all you have to do: 

1. CARTRIDGES: Tie Comrrodore 64 computer has a line of programs 
end games on cartridge. The programs offer a wide variety of business 

and personal applications and the games are just like real arcade 
games — not imitations. To load these games, first turn on your TV set. 
Next turn OFF /our Corrmadore 64 YOU MUST TURN OFF YOUR COM- 
MODORE 64 BEFORE INSERTING OR REMOVING CARTRIDGES OR YOU 
MAY DAMAGE THE CARTRIDGE AND/OR YOUR COMMODORE 641 
Third insert the cartridge. Now turn your Commodore 64 on. Finally type 
the appropriate SI ART key as is listed on the instruction sheet thai comes 
with each game. 

2. CASSETTES: Use your DAT ASS ETTE recorder and the rxdinary audio cas- 
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setteS that cOhne as part of your prepackaged program. Make sure 

the tape is completely rewound to the beginring of tbe first side. 
Then, ;ost type LOAD. The computer will answer with PRESS PLAY ON 
TAPE, so you respond by pressirg play on your datasette morhine. Ar 
this point the computer screen will go blark until the program is 
fcund. The computer will say FOUND (PROGRAM NAME) on T he 
screen. Now yoj press down or the TS KEY, This will actually 
load the program into the computer. If you want ro stop the loading: 
simply press the I key. 



DISK: Using your disk drive, carefully insert the preprogrammed disk 
so that the label on the disk is feeing up and is closest to you. Look 
for a little notch on the disk (it night be covered with a little piece a* 
tape). If you're inserting the cisk properly the notch will be on the left 
side. Once the disk is inside close "he protective gate by pushing down 
on the lever. Now type LOAD "PROGRAM NAME", 8 and hit -he 
key. The disk will make noise and yuui screen will *ay; 



SEARCHING FOR PROGRAM NAME 
LOADING 

READV 



i/Vhen the READY comes on and the B is on, just type RUN, and 
your prepackaged software is ready to use. 

LOADING PROGRAMS FROM TAPE 

Logding a program back frcm tape or disk is just as simple. For tape, 
rewind the tape back to the beginning and type: 



LOAD "PROGRAM NfiME' 



It you don't remember the program name, just type LOAD and the 
first program on the tape will be loaded into memory. 
Af-er you press (\ .""■_ •''( the computer will respond with: 
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Afle« you depress the play key, the screen will blank, Turning the 
border color of the screen as the computer searches for the program. 
(When the program is found, the screen will dispoy: 



FOUND PROGRAM NAME 



To actually lOAD trie program, depress -he key, To abandon the 
LOADing procedure, hit »:i'.K; :HBIa . If you hil the Commodore key, the 
screen will again torn the border color while the p-ogram is LOADed. 
After the LOADing procedure is completed, the screen will return to the 
normal state and the READY prompt will reappear, 

LOADING PROGRAMS FROM DISK 

Locding a program from disk follows the same format. Type: 



LORD "PROGRAM NAME", 8 



The S is the code for rhe disk, so you're just letting the computer know 
thar yog want the program loaced from the disk. 



After you hit 
shows: 



the disk will start whirring and the display 



SEARCHING FOR PROGRAM NAME 
LOADING 

READS' 
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NOTE: 

Wher you load a new program info the computer's memory, any in- 
structions that were in the computer previously will be erased. Make 
sure you save a program you're working on before loading a new one. 
Once a program has been loaded, you can RUN it, LIST it., or make 
changes and re-save the new version. 

SAVING PROGRAMS ON TAPE 

After entering a program, if you wish to save it on tape, type: 



3RVE " PROGRAM HflME' 



PROGRAM NAME" can be up to 16 characters long. After you hit 
the computer will respond with: 



PRESS PLFfV AND RECORD OH THPE 





Press both the record and play keys on the dotasette. The screen will 
blank, turning the color of the border. 

After the program is saved on tape, the READY prompt will reappear, 
indicating that you can start working on another program, or |usr turn 
off the computer for a while. 

SAVING PROGRAMS ON DISK 

Saving a progrcm on disk is even simpler. Type; 



SAVE "PROGRRM NAME" ,9 
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T he 8 is the code for the disk, so you're just letting the computer know 
you want the program saved to disk. 

After you press (^^^ the disk will start to turn and the computer 
Will respond with: 




PRINT AND CALCULATIONS 

Now that you've gotter through a couple of the more difficult opera- 
tions you need in order to keep the programs you like, lets start making 
some programs for you to save. 

Try typing the following exactly cis shown; 




If you rna<e a typing mistake, use the J.'.;' '■■■■■> | key to erase the char- 
acter immediately to the left of the cursor. You can delete as many 
characters as necessary. 

Let's see what went on in the example above. First, you instructed 
(commanded) the compute* to PRINT whatever was inside the quote 
murks. By fitting | | you told the computer to do what you in- 

structed and COMMOCORE 64 was printec on the screen, 

When you u;e the PRINT statement in this form, whatever is enclosed 

in quotes is printed exactly as you typed it. 
If the computer responded with: 

?SYNTAX ERROR 

ask yourself if you made a mistake in typing, or forgot the quote marks. 
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The computer is precise and expects instructions to be given Ir a specif c 
form, 

But don't get worried; just remember to enter things as we present 
them in the examples end you'll get along great with the Commo- 
dore 6i. 

Remember, you tun J l hurl ihe computer uy typing on ll, and Irie best 
way to learn BASIC is to try different things and see what happens. 

PRINT is one cf the most useful and powerful commands in the BASIC 
language. With it, you can display just about anything you wish, ine ud- 
ing graphics and results of computations. 

For example, try the fallowing. Clear the screen by holding down the 
QU3 key and BffHBffiB key and type (be sure to use the 'V key for 
one, not a letter 'l')r 




What you've discovered is that the Commodore 64 is a calculator in its 
bask form. The result of "24" was calculated and printed automatically. 
In fact, you can also perform subtraction, multiplication, division, ex- 
ponentiation, and advanced math functions such as calculating square 
roots, etc. And you're not limited to a single calculation on a iine, but 
more on that later. 

Note that in the above form, PRINT behaved differently from the first 
example. In this, case, a value or result of a calculation is printed, rat-he r than 
the exact message you entered because the quote marks were omired. 

ADDITION 



The plus sign (+) signals addition: we instructed the computer to print 
the result of 12 added to 12. Other arithmetic operations take a similar 
turn lu addition. Remember to always hit j-BBI-M after typing PRINT 
and the calculation. 
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SUBTRACTION 

To subtract, use the conventional minus (-) sign. Type: 



PRINT 12 - 9 
3 



MULTIPLICATION 

If you wanted to multiply 12 times "2, use the asterisk (*) to represent 
multiplication. You would type: 



PRINT 12 * tl 
144 




DIVISION 

Division uses the tamilia- "/", For example, to divide 144 by 1 1. type: 




24 



EXPONENTIATION 

In a like fashion, you can easiiy r aise a number to a power (this is the 
;gme as multiplying a number by itself a specified njmber of times}. 
The ,A ' (Up arrow) signifies exponentiation. 




Thts is the same as typing; 



PRINT 12 * 12 * 12 * 12 * 12 
248832 





TIP: 












BASIC ha? a number sf ihcrtent wn/s nf fin 


hg thhgs 


. One 


such way is 


obbrsviat- 


ing BASIC command* (or keywords). A *? cnri 


rse userl 


n nines nf PRINT. 


tnr esam- 


pie. As we 90 on 


you'll be presented with many comfflcindfi; 


Anp^ndix D 


shnws the 


abbreviation* for 


each ond whal v^ill b* dkp 


ayed on 


he screen wheri yinu type trie 


abbreviated form 













The last example brings up unolhet important point: many calcula- 
tions may be performed on the sarre line, and they can be of mixed 
types. 

You could calculate this problem: 
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Up to this point we've just used small numbers and simple examples. 
However, the Commodore 64 is capable of more complex calculations, 

You could, for example, add a number of large figures together. Try 
this, bit don't use any commas, or you'll get an error: 



345.73 + 7895.687 



S3*4.3li 



That looks fine, but now try this: 



? 12123123.45 
12131364.9 



7895 . 6S7 



If you tooc the time to add this up by hard, you would get a different 
result. 

Whal's going an here? Even though the computer has a lot of power, 
there's a limit to the numbers it can Kandle, The Commodore 64 can 
work with numbers containing 10 digits. However when a number is 
printed, only nine digits are displayed. 

So in our example, the result was "rounded" lo fil in the proper 
range. The Commodore 64 rounds up when the next digit is five or more; 
it rounds down when the next digit is four or less. 

Numbers between 0.01 ond 999, "599, 999 are printed using standard 
notation. Numbers outside this range are printed using scientific Hala- 
tion. 

Scienriflc notation is just a process of expressing a very large or small 
number as a power of 10. 

If you types 
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1 his. is the same as 1.23 * 10J17 and is used just to keep things tidy. 
There is a limit to tie numbers the computer can handle, even in 
scientific notation. These limits ore: 

Largest; ± 1.70141 183E I 38 

Smallest (different from zero): ± 2.Y38735B8-39 

PRECEDENCE 

If you tried to perform some trilled calculations different from The 
examples we showed earlier, you might not have gotten the resulls that 
you expected. The reason is that the computer performs calculations in a 
certain order. 

In this calculation; 

20 + 8/2 
you can't tell whether tie answer should be 24 or 14 un-il you know in 
which order to perform the calculations. If you add 20 to 8 divided by 2 
(or 4), then the result is 24. But, if you add 20 plus 8 and then divide by 
2 the answer is 14. Try the example and see whet result you get. 

The reason you got 24 is because the Commodore 64 performs calcu- 
lations Isft to right according lo lire following: 

First: — minus sign indicating negative numbers 

Second: * exponentiation, left to right 

Third: *f multiplication and divisions, left to ight 

Fourth: + — addition and subtraction, lefr to right 

Follow along according to the order of precedence, and you will see 
that in the above example the division was performed first and then the 
addition to ge" c result of 24. 

Make up some problems of your own and see if you can follow along 
and predict the results according to the rules set down above. 

There's also an easy wuy to alter the precedence process by using 
parentheses to set ofF which operations you want performed first. 

For example, if you wont to divide 35 by 5-plus-2 you type: 
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you will get 35 divided by 5 wi'h 2 added tc the answer, which is not 
what you intended at all. To get what you really wanted, try this: 







BfflH| mm iIIHB^HH ' 



What happens now is that the computer evaluates what is contained 
in the parentheses first. If there are parentheses within parentheses, the 
innermost parentheses are evaluated frst. 

Where ^here are a number of parentheses on a line, such as: 




the computer evaluates them left to right. Here 21 wojld be multiplied 
by 7 for the result of 147. 



COMBINING THINGS 



Even though we've spent a lot of time in areas that might not seem 
very fm portent, the cetails presented here will make more sense once 
you start to program, and will prove invaluable. 

To give you an idea how things fit in place, consider the following: 
how coufd you combine the two types of print statements we've exam- 
ined so far to print something more meaningful on the screen? 

We know that by enclosing something within quote marks prints thai 

information on the screen exactly os it wos entered, and by using math 
operators, calculations can be performed. So why not combine the two 
types of PRINT statements like this: 



SEM CO-OP. WEANS NO S>ACE. 



"5*9= " 

* 9 = 45 



; 5 * 9 
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Even thc,Lgh this might Seem a bit reduncant, what we've done is 
simply use both types of print statements together. The first part prints 
"5 9 = " exactly us il wCs lyptid. The fecund purl due* the uctuul work 

and prints the result, w : th the semicoon separating the message part of 
the statement from the actual calculation. 

You con separate the parts of a mixed print statement with punctua- 
tion for various formats. Try O comma in place of the semicolon and see 

what happens. 

For the curious, the semicolon causes the next part of the statement to 
be printed immediately after the previous part without any spaces. The 
comma does somethirg different Ever though it is an acceptable 
separator, h spaces things out more. If you tyP e: 




the numbers will be printed across the screen and down on to the next 
line. 

The Commodore 64's display is organized into 4 areas of 10 columns 
each. The comma tabs each result into the next available area. Since 
we asked for mere information to be printed than would fit on one line, 
(we tried to fit five 1 0-eolumn areas on one line) tne last item was moved 
down lo the next line. 

The basic difference between the comma and semicolon in formatting 
PRINT statements can be used to our acvantage when creating more 
complex displays: it will allow us to create some sophisticated results 
very easily. 



Up to now we've performed seme simple operations b/ entering a 
single line of Instructicns into the computer. Once (23E^1 was de- 
pressed, the operation that we specified was performed immediately. 
This is called the IMMEDIATE or CALCULATOR mode. 

But to accomplish anything significant, we must be able to hove the 
computer operate with mare than a sirgle line state mem, A number of 

statements combined together is called a PROGRAM and cllcws you to 
use the full oower of the Commodore 64. 

To see how easy it is to write your first Commodore 64 program, try 
this: 



Clear the screen by holding the ^^Q key, and then depressing the 

miiiv.'.ia key. 

Type NEW and press mUJJJJ. : I his fust clears out any numbers that 
might have been left in the computer from your experimenting.) 
Now type the following exactly ai shown (Remember to hit 
after each line) 




Now, type RUN and hit ^^^^( — wutch what happens. Ycur screen 
will come alive with COMMODORE 64. After you've finished watching 
the display, hit HUfffiffl J to stop the program. 

A number of important concepts were introduced in this short pro- 
gram that are ihe basis for all programming. 

Notice that here we preceded each statement with a number. This 
LINE number tells the comptter ii what order to work with each state- 
ment. Th^se numbers are also a reference point, in cose the program 

needs to get back to a particular line. Line numbers can be any whole 
number (integer) value between 0-63,999, 

10 PRINT "COftVMODORE 64" 

" — STATEMENT 
LINE hllJMhF? 
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It is good p-ogramming prac"ice to number lines in increments of 

10 — in case ycu need to Insert some statements later on. 

Besides PRINT, our program also used another BASIC command, 
GOTO. This instructs the computer to go directly to a oarticular line and 
perform it, then continue from that point, 

■* 13 PRINT "COMMODORE 64" 



- 20 GOTO 10 

In our exanple, the program orints the message in line TO, goes to 
the Text line (20), which instructs it tc go back to line and print the 
message over again. Then the cycle repeats. Since we didn't give the 
computer a way out of this loop, the program w II cy:le endlessly, until 

we physically stop it with the Q _ r j Ley. 

Once you've stopped the program, type: LIST. Your program will be 

displayed, intact, because it's still in the computer's memory. Notice, 
tnc>, that the nompirer converted the ? into PRINT for ycu. The program 
can now be changed, saved, or run again. 

Another important difference between typing something in the im- 
mediate mode and writing a program is that once you execute and 

clear the screen of gn immediate statement, it's lost. However, you can 
always get a program back by ju3t typ'ng LIST. 

By the way, when it corres To abbreviations dor't forget That The 
computer may -un out of space on a line if you use too many. 
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EDITING TIPS 

If you make a mistake on a tine, yoj have a number of editiig 
options* 

1. You can retype a line anytime, and the computer will automatically 
substitute the new line for the old one. 

2. An unwanted line cars be erased by simply typing the line number 
and KBffHfp . 

3. You can also easily edit an existing line, using the cursor keys and 
editing keys. 

Suppose you made a typing mistake in a line of the exomple. To 
correct it without retyping The entire line, try This: 

Type LIST, thei using the |3Jj| arld flE^M keys together move the 
cursor up until it is positioned on the line That needs to be charged. 

Now, use the cursor-right key to move the cursor to the character you 
want to change, typing The change ove r the old character. Now hit 
J2EEM an ^ the corrected line will replace the old one. 

If you need more space on the line, position the cursor where the 
space is needed and hit ^^Q and |Jjj*£.2£J at ths same time and a 
space will ooen up. Now just "ype in the additional information and hit 
|^2^^ . Likewise, you con delete urwanted characters by placing The 
cursor to the right of the unwanted character and hitting the ffffi^ ft 
key. 

To verify that changes were entered, type LIST again, and the cor- 
rected program will be displayed! And lines don't have to be entered in 
numerical order. The computer will automatically piece them ir the 
proper sequence. 

Try editng our sample prog-am on page 33 by changing line 10 and 

adding a comma to the end of the line. Then KUM the program again. 

,„ „„,>.„■ „^ rt ...,„„„„^„ "^^■OOMt FORGET IO MOVE THE 

10 PRI NT "COMMODORE", 

YOU BUM THE PROGRAM. 

VARIABLES 

Variables are some of the most used features of any programming 
language, because variables can represent much more information in 
the computer. Understanding how variables operate will make comput- 
ing easier and allow us to accomplish feats that would not be possible 
otherwise. 
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commodore 

commodore 

COMMODORE 

COMMODORE 

COItMOOORE 

COMMODORE 

COMMODORE 

COMMODORE 

COMMODORE 

COMMODORE 

COMMODORE 

COMMODORE 

COMMODORE 

BREAK IN 10 

REBDV 



COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 



commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 
commodore 



CUMMUUORE 
COMMODORE 
LUMMODORE 
COMMODORE 
COMMODORE 
COWMODOEE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 



Imagine a number of boxes within the computer that can each hotd a 
number or a string of text characters. Each of these boxes is to be 
labeled with a name that we choose. Thai name is called c variable 
and represents the information in the respective box. 

For example, if we say: 

10 X% = 15 
20 X - 23.5 

30 X$ = "THE SUM OF X%+X = " 

The computer might represent the variables like this: 
X% 1 5 



23.5 



X$ THE SUM OF X%-X = 

A vocable name represents the box, or memory location, whero the 

current value of the variable is stored. As you can see, we can assign 
either an integer number, floating point number, or a texl string to o 
varioble. 

The % symbol following a variable name indicates the variable will 
represent an integer number. The following are valid integer variable 
names: 
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x% 

Al% 
NM% 

The '$' following the variable name indicates tine variable will repre- 
sent a text Strng. The following are examples of string variables: 

A$ 
X$ 
MIS 

Floating point variables follow the same format, with the type indi- 
cator: 

Al 
X 

Y 
Ml 

In assigning a name to a variable there are a few things to keep in 
mind. First, a variable name can have one or two cnaracters. The first 
character mjst be an alphabetic character from A to Z; the second 
character can be either alphabetic or numeric (in the range to 9). A 
third character can b« included to indicate the type gf variable linleger 
or Text string), % or $, 

You can use variable names having more than two alphabetic 
characters, but only th» first two tire recognized by the computer. So 

PA and PARTNO are the same and would refer to the same variable 
box. 

The last rule for variable names is simple: -hey can't rontnin any 
BASIC keywords (reserved words) such as GOTO, RUN, etc. Refer back 
tc Appendix D for a complete lisl of BASIC reserved words. 

To see how variables can be pir to work, type in the complete pro- 
gram that we introduced earlier and RUN it. Remember ro hit I 



after sazh line in th 



e program. 



NEW 












10 


X'/. = 15 














20 


X — 23a 5 
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X* = "THE 


SUM 


OF 


XX 


+ 


X = " 


40 


FRIHT "X?: 


- "'; 


1 XK 


Jf 


■X 


= ".: X 


5@ 


PRINT X*.; 


y,y. - 


i x 
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If you die everything os shown, you should get the following result 
printed on the Screen. 



«J X = 23.5 . 

THE SUM OF >"'. + X = 38.5 



READV 



We've put TogeTher all the tricks learned so far to fcrmat the display 
as you see it and print the sum of the two variables. 

In I'nes 1 and 20 we assigned an integer value to X% and assigned a 
floating point value to X. This puts the number associated with the vari- 
able in its box. In line 30, we assigned o text string to X$. Line 40 
combines the two types of PRINT statements to print a message ard the 
actual value of X% and X. Line 50 prints the text string assigned to X$ 
and the sum of X% and X. 

Note that even though X is used as part of each variable name, the 
identifiers % and $ make X%, X, and X$ unique, thus representing 
three distinct variables. 

But variables are much more powerful. If you chang* their volu«, the 
new value replaces the original value In the sane box. This allows you 
to write a statement like: 

X = X + 1 

This wojld never be accepted in normal algebra, but is one of the 
most used concepts in programming. It means: take the current value of 
X, add one to it and place the new sum into the box representing X. 



IF 



THEN 



Armed with the ability to easily update the value of variables, we can 
now try a program sjch as: 
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What we've done ts introduce two new BASIC commands, and pro- 
vided some control over our runaway little print progrom introduced at 
the start of This chaprer. 

IF . . . THEN adds some logic to the program. It says IF a condition 
halds true THEN do something. IF the condition no longer holds true, 
THEN do the next line in the program. 

A number of conditions can be set up in using on IF . . . THEN slule- 
ment: 

SYMBOL MEANING 

< Less Than 

> Greater Than 

= Equal T3 

< > Not Equal To 

> = Greater Than or Equal To 

< = Less Than or Equal Td 

Trie use of any one of these conditions is simple, yet surprisingly 
powerful. 

10 CT = a 
-» 20 ?"COMMODORE 64" 

30 CT = CT + 1 
- 40 IF CT < 5 THEN 20 

I 
50 END 
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In the sample program, we've set up a "loop" that has some con- 
straints placed on it by saying: !F a value is less them some number 
THEN do something. 

Line 10 sets CT (CounT) equal to 0. Line 20 prints our message. Line 30 
odds one to the variable CT. This line counts how many times we do the 
loop. Each time the loop is executed, CT goes up by one. 

Line JO is our control line. If CT is less than 5, meaning we've exe- 
cuted the loop less than 5 times, the program goes bock to line 20 and 
prints again. When CT becomes equcl to 5 — indicating 5 COAIMODORE 
64' s were printed — the program goes to line 50, which signals to END 
the program. 

Try the program and see what we meon. By changing the CT limit in 
line 40 you can have any number of lines printed. 

IF . . . THEN has a multitude of other uses, which we'll see in future 
examples. 



FOR . . . NEXT LOOPS 

There is a simpler, and preferred way to accomplish what ws did in 
the previous example by using a FOR . . . NEXT loop. Consider the 
following: 



MEW 

10 FOR CT = 1 TO 5 

20 PRINT "COMMODORE 64" 

30 NEXT CT J 

RUN 

COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 





As you con see, the program has become much smaller and more 
direct. 

CT starts ul 1 in line 10. Then, line 20 does some printing. In Line 30 
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CT is incremented by 1. The NEXT statement in line 30 automatically 
sends the progrom back to line 10 where the FOR part of the FOR . . . 
NEXT statement Is located. This process will continue until CT reaches the 
limit yog entered. 

The variable used in a FOR . . . NEXT loop can be incremented by 
smaller amounts than 1, if needed. 

Try this: 



10 FOR NB - 1 TO 19 STEP .5 
29 PRINT NB, 
39 NEXT HS 



If you enter and run this program, you'll see the numbers from 1 to 
10, by .5, printed across the display. 

All we're do ; ng here is printing the values that NB assumes as it goes 
through the loop. 

You can even specify whether the variable is increasing or decreas- 
ing. Substitute the following tor line 10: 

10 FOR NB = 10 to 1 STEP -.5 

and walch tie ooposite occur, as NB goes from 10 to 1 in descending 
order. 
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INTRODUCTION 

The next : ew chapters have been written £ or people who hove be- 
come relatively fomiiinr with the BAS'C programming language arid the 
concepts necessary to write more advanced programs. 

For those of you who are fust starring to learn how to program, you 
may find some of the information a bit too technical to understand 
completely. But taxe heort. . . because for these two fun chapters, 
SPRITE GRAPHICS and CREATING SOUND we've set up some simple 
exomples that are written for the new jser. The examples will give you 
a good idea of how to use the sophisticated sound and graphics 
capabilities available on your COMMODORE 64. 

If you decide that you want to lecirn more abaut writing programs in 
BASIC, we've put a bibliography (Appendix N) in the back of this man- 
ual. 

If you ore already familiar with BASIC programming, these chapters 
will hslp you get slarted with advanced BASIC programming techniqu- 
es. More deiuiled information car: be found in the COMMODORE 64 
PROGRAMMER'S REFERENCE MANUAL, available through your local 
Cornrrodore dealer. 
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SIMPLE ANIMATION 

Let's exercise some of the Commodore 64's graphic capabi ities by 
put~mg together what we've $eei so far, together with a few new - con- 
cepts. If you're ambitious, type in the following program and see what 
happens. You will notice that within the print statements we can also 
include cursor controls and screen commends. When you see something 
like {CRSR LEFT} in a program listing, hold the ^Q key and hit the 
CRSR LEFT/ RIGHT key. The screen will show tne graphic representation 
of a cursor left (two vertical reversed bars). In the same way, pressing 
and B "' ER 13 shows ns a reversed heart. 



NEW 




INDICATES NEW 

10 REM BOUNCING BALL (^ COMMAND 

20 PRINT "{CLR/HOME} 



25 FOR X = i TO 10 : PRINT " {CRSR/OOWN} " ; NEXT 

39 FOR BL = 1 TO 40 

40 PRINT"i«fCRSR LEFT}";:REM (• is a SHIFT-Q? 
50 FOR TM ^SkJO g 
60 NEXT TM \^ 
?& NEXT BL 



-PttieseIpacePi 
(are jntentional j 



75 REM MOVE BFfCL RIGHT TO LEFT 

80 FOR BL>^4B TO i STEP -1 

30 PRINT" f {CRSR LEFT) (CRSR LEFT)»{CRSR LEFT) 

106 FOR TM = 1 TO 5 

110 NEXT TM 

126 NEXT BL 

130 GOTO 20 



TIP: 
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The prograrr. will display a bouncing ball noting from left to right,, 
and back again, across the screen. 

If we look at the program closely, {shown on pnge 44) you can see 
how this feat was accomplished. 

Line 10 is a REMark that just tells what the program does; it has no 
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10 REM BOUNCING BRLL 
-26 PRINT " {CLR/HOME} " 
-25 FOR X = 1 TO 10 : PRINT " (CRSR/OQWN} " i NEXT 

30 FOR BL = 1 TO 40 

40 PRINT" • {CRSR LEFT} ".; -REM C» i £ a SHIFT-Q? 
"50 FOR TM = 1 TO 5 
■SB NEJ4T TM 
-70 NE^T BL 

7S REN MOVE SflLL RIGHT TO LFFT 
-80 FOR BL MB TO 1 STEP -1 

30 PRINT" {CRSR LEFT} {CRSR LEFT}»{CRSR LEFT} "; 
-100 FOR TM = 1 TO 5 
-110 NEXT TM 
-120 NEXT SL 
■ 1 30 GOTO 20 



effect on the program itself. Line 20 clears the screen of any informa- 
tion. 

Line 25 PRINTs 10 cursor-down commends. This just positions the ball 
in the middle cr the screen. If line 25 was eliminated the bell would 
move across the top line of tie screen. 

Line 30 sets up a loop for moving the ball the 40 columns from the left 
to right. 

Line 40 does a lot of work. It first prints a soace to erase the previous 
ball positions, then it prints the ball, and finally It performs a cursor-left 
to get everything ready to eras© ihe cur»ent boll posnon again. 

The bop set op in lines 50 end 60 slows the ball down a bit by delay- 
ing the program. Without it, the ball would move too fast to see. 

Line 70 completes the loop that prints balls on the screen, set up in 
line 30. Each time the loop is executed, the ball moves another space to 
the right. As you notice from the illustration, we have set up a loop 
within a loop. 

This is perfectly acceptable. The only time you get in trouble is when 
the loops cross over each other. It's helpful in writing programs to check 
yourself as illustrated here to make sure the logic of a loop is correct. 

To see whal would happen if you cross a loop, reverse the statements 
in lines 60 and 70. You will get an error because the computer gets 

confused and cannot figure out what's going on. 

Lines 80 through 120 just reverse the steps in the first part of the 
program, and move the ball from right to left. Line 90 is slightly differ- 
ent from line 40 because the ball is moving in the opposite direction ('we 
have to erase the ball to the rieht and move to the left). 
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And when that's all done the program goes back to line 20 to start the 
whole process over again. Pretty neat! To stop the program hold 

down ^^^jU and hit |; ;V^_ 

For a variation on the program, edit line 40 to read: 



40 PRINT "•"; ■*- 



TO MAKE "M6 •. HOIO THE SHIFT 
KEY DOWN AMD HIT THE LETTER "Q," 



Run the program ond see what happens now. Because we left out the 
cursor control, each ball remains on the screen until erased by the ball 
moving right to left in the second part of the program, 

INPUT 



Up to now, everything within a program has been set before it is run. 
Once the program was started, nothing cauld be changed. INPUT 
allows us to pass new information to a program as it is running and 
have that new infarmotion acted upon. 

To get an idea of how INPUT works, type NEW J[vPf Jand enter this 
short program: 



10 INPUT A* 

20 PRINT "YOU TVPED: " ?fl* 

30 PRINT 

40 GOTO 10 -- 

RUN 

7 COMMODORE 64 

VOLI TVPED: COMHODORE 64—" 



YOU TYPED 

COMPUTER 
RESPONDED 



What happens when you run this program is simple. A question mark 
will appear, indicating that the computer is wa'ting for you to type 
something. Enter any character, or group of characters, from the 

keyboard and hit J:' '"' | The computer will then respond with "YOU 
TY'ED :" followed by the information you entered. 

This may seem very elementary, but imagine what you can have the 
computer do with any information you enter. 

You can INPUT either numeric or string vqriciloles, and even hove the 
INPUT statement prompt the userwirh a message. The format of INPJT is: 

INPUT "PROMPT MESSAGE",- VARIABLE 



fKJUPTMUST IE 3B CHAIACTMi OK LEiS 
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Or, fust: 

INPUT VARIABLE 

NOTE: To gel out of this program hold down the [ J and 

keys. 



The following prograin is not only useful, but demonstrates a lot of 

what has been presented so tar, including the new input statement. 



MEW 



1 REM TEMPERATURE CONVERSION PROGRAM 

5 PRINT "{CLR/HOME} ■' 

19 PRINT "CONVERT FROM FAHRENHEIT OR CELSIUS 

<F/CVt INPUT A* 

2Et IF fit = "I f THEM 29 

33 IF A* = "F" THEN 109 

43 IF R* O "C" THEN IB 

59 INPUT "ENTER DEGREES CELSIUS: » ;C 

£0 F = <C*9>/5-t-32 

70 PRINT C?" OEG. CELSIUS es » f F.f" OEG. 

FAHRENHEIT" 
80 PRINT 
9S GOTO 1© 

leg INPUT "ENTER DEGREES FAHRENHEIT! " -F 
lie C = <F-32>*5^9 

120 PRINT FV DEG. FAHRENHEIT = "jC,»" OB 
CELSIUS" 

139 PRINT 

140 GOTO 10 




If you enter and run this program, you'll see INPUT in action. 

Line 10 uses the input statement to not only gather information, but 
also print our prompt. Also notice that we can ask for either a number or 
string (by using a numeric or string variable). 

Lines 20, 30, and 40 do some checks on what is t/ped in. In fine 20, if 
nothing s entered (just 9 ^9 ' s bit), then the program goes back to 
line 10 ond requests rhe input again. In line 30, if F is typed, you know 
the user warts to convert a temperature in degrees Fa h re rhe it to Cel- 
sius, so the program branches to the part that does that conversion. 

Line 40 does one more check. We know there are only two valid 
choices the user can enter. To get 10 line 40, the user must have typed 
some character other than F. Now, a check is made 1o see if that char- 
acter is a C; if not, the program requests input again. 

This may seem like a lot of detail, but it h good programming prac 
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tice. A user not ■familiar with the program can become very frustrated if 
it does something strange because a mistake was made entering infor- 
mation. 

Once we determine what type of conversion to perform, the program 
does the calculation and prints out the temperature entered ar.d the 
converted temperature'. 

The calculation [5 jyst s'raigit math, using the established formula for 
temperature conversion. After the calculation is finished and answer 
printed, the p'ogram loops back and starts over. 

After running, the. screen might look like this: 



CONVERT FROM FAHRENHEIT OR CELSIUS <F/C> : ?F 

ENTER DEGREES FAHRENHEIT: 32 

32 DEO. FAHRENHEIT = & DEG. CELSIUS 

CONVERT FRQrl FAHRENHEIT OR CELSIUS <F/C> : ? 



After running the program, rrake sure to save it on disk or tape. This 
program, as well as others presented 'hfoughout the manual, can form 
ihe base of your program library. 



GET 



GET allows you to input one character ot a -irne from the keyboard 
without hiftina fl-BPHM . This really speeds entering data in many appli- 
cations. Whatever key is hit is assigned to the var able you Specify with 
GET. 

ihe following routine illustrates how GET works: 



NEW 

1 PRINT " {CLR/HOflE} " 

16 CET Bti IF fl* = ' V THEN 19 

20 PRINT ft*; 

36 OOTO IB 




47 




If you RUN the prograrr, the screen will cleor and each time you hit a 
key, line 20 will print it on the display, and then GET anotner character. 
It is important to note that the character entered will not be displayed 
unless you specifically PRINT it to the screen, as we've done here. 

The second statement on line 10 is also important. GET continually 
works, even if no key is pressed (unlike INPUT that waits for a resoonse), 
so the second part of this line continually checks the keyboard until a key 
is hit. 

See what hupaens if the second part of line 10 is eliminated. 

To stop this program you can hit the |yjjjjmjy and [j^EES keys. 

The first part of the temperature conversion program could easily be 
rewritten to use GET. LOAD the temperature conversion program, and 
modify lines 10, 20 and 40 as shown; 



1@ PRINT "CONVERT FROM FAHRENHEIT OR CELSIUS 

< F/C > M , 

2& GET ft*: IF ft* « "*' THEN £0 
4tf IF ft* O "C" THEN 2@ 



This modification will -nake tne program operate smoother, as nothing 
will happen unless the user types in one of the desired responses to 
select the type of conversion. 

Once this change is made, make sure you save the new version of the 
program. 



RANDOM NUMBERS AND OTHER FUNCTIONS 

The Commodore 64 contains a number of functions that are used to 
perform special operations. Functions could be thought of as built-in 
programs included in BASIC. But rather than typing in a number of 
sta-ements each time you teed to perform a specioii7ed calculation, you 
just type the command for the desired function and 'he computer dees 
tie rest. 

Many times when designing a game or educational program, you 
need to generate a random number, to simulate the throw of dice, for 
example. You could certainly write a program that would generate these 
numbers, but an easier way to call upon the RoNDom number furction. 

To see what RND actually does, try this short program: 



NEW 

10 FOR 
20 PRINT 
30 NEXT 



X = 1 TO 10/7F 
IT RND<1>,^-V 

I 



YOU LEAVE OUT THE COMMA YOUR LIST] 
OF NUMBERS WILL APPEAR 
AS 1 COLUMN 



After running the progrom, you will see a display like this: 




Your numbers don't match? Well, if They did we would all be in 
trouble, as they should be comoletely random! 

Try running the program a few mo'e times to verify that the results are 
always cifferent. Ever if the numbers don't follow any pattern, yoj 
should start to notice that some things remain the same every time the 
program is run. 

First, the results are always between and 1, but never equal to or 
1 , This will certoinly never Ho if we wnnt to simulrtte the random toss of 
dice, since we're ooking for numoers between 1 and 6. 

The other important feature to look for is that we are dealing with real 
numbers (with decimal places). This could also be a problem since 
whole (integer) numbers are oflen needed. 

There are a number of simple ways to produce numbers f'om the 
RND function in the range desired. 

Replace line 20 with the following and run the program again: 



20 PRINT e*P.hiO''A.\ 



S.472SC;963 
- ""054 



4.53660S53 

4. 3954 76S8 

5.5@S;2w7't9 
4. 17090292 



4* 



Thut cured the problem of net having results larger than 1 , but we still 
have the decimal part of the result to deal witn. Now, another function 
can be called upon. 

Trip INTeger function converts 'eal numbers into in*eger values. 

Once mor*, *eplcc£ line 20 with the following and run the program tu 

see the effect of The change: 



29 PRINT 


INT<6*RHD( 


t>>. 






RUN 




. 






a 


3 


1 







S? 


4 


3 


5 







1 









That took care of a lot, getting us closer to our original goal of 

generating random numbers between 1 and 6. If you examine closely 
what we generated this last Time, you'll find that the results range from 
to 5, only. 

As a last step, add a one to the statement, os follows: 

20 PRINT INT{6*RND(1)] + 1, 

Now, we nave achieved the desired results. 

In general, you can place a number, variable, or any BASIC expres- 
sion within the pnrentheses of the INT function. Depending on the range 
desired, you jjst multiply the upper limit by the RND function. For 
example, to generate random numbers between 1 and 25, you could 
type: 

20 PRINT INT(25' f RND(1»+] 

The general formula for generating n set of random numbers in a 
certain range is: 

NUMBER=INT(LOWER LIMIT t(UPPER-LOWER+l)*RND(l)) 



GUESSING GAME 

Since we've yune lu some lengths lu under slut id undoni numbers, 
why not put this information to use? fhe following game not only i II us— 
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trares a good use of random numbers, but also introduces some addi- 
tional programming theory. 

In running this program, a random number, NAA, will be generated. 



NEW 



■ INDICATES NO 
SPACE AFTER 
QUOTATION MARC 



1 REM NUMBER GUESSING SAME 

2 PRIHT "tCLR/HOMEJ" 
5 INPUT "ENTER UPPER LIMIT FOR GUESS 

19 NM = INT<LI*RNO<m + l 
15 CN = 

20 PRINT "J-VE GOT THE NUMBER. " iPRINT 
30 INPUT "WHHT'S YOUR GUESS"; GU 

35 CN = CN ■ + 1 

40 IF GU > NM THEN PRINT "MY NUMBER IS 

LOWER": PRINT : GOTO 30 
50 IF GU < NM THEN PRINT "MY NUMBER IS 

HIGHER" : PRINT : GOTO 30 
60 PRINT "GREAT ! VOU GOT NY NUMBER" 
65 PRINT "IN ONLY " ; CN ; "GUESSES. ": PR INT 
70 PRINT "DO YOU WANT TO TRY ANOTHER CV/NJ" 
80 GET HNS: IF HN*="" THEN 80 
90 IF HN$ = "V" 1HEM 2 
100 IF AN* O "N" THEN 78 
110 END 



You can specify how large rhe number will be at the start of the pro- 
gram. Then, it's up to you 1o guess what the number is. 
A sample run follows along with an explanation. 



,ENTER UPPER LIMIT FOR GUESS? i 
I'VE GOT THE NUMBER. 

WHAT'S VOUR GUESS ? 15 
MY NUMBER IS HIGHER. 

WHAT'S VOUR GUESS ? 20 
'MY NUMBER IS LOWER. 

jWHRT'S VOUR GUESS ? 19 
■GREAT! YOU GOT MY NUMBER 
IN ONLY 3 GUESSES. 

iDO YOU WANT TO TRY ANOTHER <Y, 
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IF/THEN statements compare your guess to the number generated. 
Depending on your guess, the program tells you whether your guess was 
higher or lower than the random number generated. 

From the formula given for determining rancom number range, see if 
you cun add a few lines to the program that allow r he user to also 
specify the lower range of numbers generated. 

Each 'ime you make a guess, CN is incremented by 1 to keep track of 
the number of guesses. In usirg the program, see if you can use good 
reasoning to guess a number in the least number of tries. 

When you get the right answer, the program prints out the "GKbAT! 
YOU GOT MY NUMBER" message, along with the number of tries it took. 
You can then start the process over again. Remember, the program 
generates a new random number each time. 



PROGRAMMING TIPS: 



In lines 40 and 50, a colon h used io sepur-ule rnuliipl'e siutprrnjnls en c :> i'yfe Jine. 
This not orly saves Typing, bu" In long programs will conserve memory space. 

Also notice in The IF/THEN sTaremerts on the same two lines, we insTrucTe-d The 
computer To PRINT something,, rather than immediately branching tc same other pain" 
In The program. 

The last point illustrates the Reason, behind using line lumbers in Increments D f 10. 
After the program was written, we decidec tc add the count part. By just adding 
those new fines at the end of the program, numb ere c to foil between the proper 
existing lines, the program was easily modified. 



YOUR ROLL 

The following program simulates the throw of two cice. You can enjoy 
it as it stands, or use it as part of a larger game. 



5 PRINT " Care "to try your luck? " 
10 PRINT "RED DICE = " J INT<6*RHD<1 » + l 
20 PRINT "WHITE DICE = " ; IHT<6#RND<1 > >+l 
36 PRINT "HIT SPACE BAR FOR HNOTHtK ROLL" : PR INT 
46 GET A*: IF Fl* = " " THEN 40 
50 IF Fl* = CHR*C3£> THEN IB 

Care to try your luck? 

From what you've learned about random numbers and BASIC, see if 
you can follow what is going on. 
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RANDOM GRAPHICS 

As a final note on random numbers, and as on introduction to design- 
ing graphics, take a moment to enter ond run this neat little program: 



10 PRINT " {CLR/HOMP.} " 

2»3 PftlHT DHPi^Sfl^.S + RND ■;' i i i ; 

40 GOTO 28 





As you may have expected, line 20 is the key here. Another function, 
CHR$ (Character String), gives you a character based on a standard 
code number from to 255. Every character the Commodore 64 can 
print is encoded this way (see Appendix F). 

To quickly find out the code for any character, just type: 

PRINT ASCC'X") 

where X is the character yot're checking {this can be any printable 
character, including graphics) The response is the code for the char- 
acter you typed. A3 you probably figured out, "ASC" s another function, 
which returns the standard 'ASCII" code for the character you typed. 
Yol car now print that cha'atter by typing: 

PRINT CMR$(X) 

If you try typing: 

PRINT CHR$ (2^5); CHR$<206> 

you will see the two right side grnphic characters on the M and N keys. 
These are the two characters that the program is using "or the maze. 

By using the formula 205.5 + RND(T) the computer will pick a random 
number between 205,5 and 206.5. There is a fifty-fifty chance of the 
number being ahnve or below 206. CHR$ ignores any fractional values, 
so half the time the character with code 205 is printed and the remain- 
ing rime code 206 is displayed. 

If you'd like to experiment with this program, try changing 205,5 by 
adding or subtracting a couple tenths from it. This will give either char- 
acter a greoter chance of beiig selected. 
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CHAPTER 



ADVANCED COLOR 

AND GRAPHIC 

COMMANDS 

Color ond Graphics 

PRINTing Colors 
- Color CHRS Codes 
» PEEKs and PQKEs 

• Screen Graphics 

* More Bouncing Balls 



COLOR AND GRAPHICS 

Up to now we've explored some af the sophisticated computing 
capabilities of the Commodore 64. But one of its most fascinating fea- 
tures is an outstanding ability to produce color and graphics, 

You'vs seen a quick example of graphics In the "bouncing ball" and 
"maze" programs. But these only touched on the power you command. 
A number of new concepts will be introduced in this section to explain 
graphic and color programming and show how you can create your own 
yurnes und advanced oriirnat'on. 

Because we've concentrated on the computing capabilities of the ma- 
chine, all the displays we've generated so far were a single color (light 
blue text on a dark: blue background, with a light blue border). 

In this chapter we'll see liuv» to odd colut If pruyiurna and control all 
those strange graphic symbols on the keyboard. 



PRINTING COLORS 

As you discovered if you tried the color alignment test in Chapter 1, 
you can change text colors by simply holding the EiT-J key nne one of 
the color keys. This works fine in the immediate mode, but what hap- 
pens if you want to incorporate color changes in your programs? 

When we showed the "bouncing ball" orogram, you sow how 
keyboard commands, like cursor movement, could be incorporated 
within PRINT statements. In a like way, you can olso add text color 
changes to your programs. 

You have a full range of 16 text colors to work with. Using the^^^ 
key and a number key, the fallowing colors ore available: 

12 3 4 5 6 7 8 

Black While Red Cyun Purple Gieen Blue Yellow 

If you hold down the Q key along with the appropriate number 
key, these additional eight colors can be used: 



1 


2 


3 


4 


5 


6 


7 


8 


Oranae 


Brown 


Lt. 

Red 


Gray 1 


Gray 2 


Lt. 
Green 


Lt. 
Blue 


Gray 3 



TYPE NEW, and experiment with the tcllow ; ng. Hold down the| 
key and at "he same time hit the W key. Next, hit theHkey without 
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holding down the [' ■J key. Now, while again depressirg the^^Hkey 
at the same time hit the^Jkey. Release the ( J<ey and hit theQkey. 
Move through the numbers, alternating with the letters, end type out the 
word RAINBOW as follows: 

10 PRINT" R^I^B^W" 



RUN 
RAINBOW 

Just as cursor controls show as graphic cha-acters within the quote 
marks of print statements, color controls are also represented os graphic 
characters. 

In the previous example, when you held down j'!' Jard typed^Ja 
"£" was displayed. ^^3D displayed a "•*—". Each color contra will 
display its unique graphic code when used in this way. The table shows 
the graphic representations of each prinraole color contro . 



m 
m 



KEYBOARD COLOR DISPLAY 

BLACK I 

WHITE 

;ed 

lVAN 
'URPLE 
GREEN 
3LUE 

YELLOW 

Even though the PRINT statement may look a bit strange on the 
screen, when you RUN the program, only the text will be displayed, Ard 
it will automatically change colors acco'ding to the color controls you 
placed in the print statement. 

Try a few examples of your own, nixing any r umber of colors within a 
single PRINT statement. Remember, too, you can use tha second set of 
*ext colors by using the Commodore key and llie number keys. 



KEYBOARD 


COLOR 


DISPLAY 


BO 


ORANGE 


h-4 


E3D 


EKOWN 


E 


HO 


LT. RED 


►H 


sa 


GRAY 1 


m 


S3D 


GRAY 2 


" 


so 


LT. GREEN 


ii 


so 


LT. BLUE 


□ 


QQ 


GRAY 3 


■■ 



HP: 
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COLOR CHR$ CODES 



Take a brief look or Appendix F. then rum beck to this section. 
You may have noticed in looking over the list of CHR$ codes in 
Appendix F that each colcr (as well as most other keyboard controls, 

such as cursor movement! has a unique code. These codes con be 
printed directly to obtain the same results as typing QQj and the 
appropriate ksy within the PRINT statement. 
Tor example, try this: 




The Text should now be green. In muny cusas, using the CHR$ func- 
tion will be much easier, especially if you want to experiment with 
changing colors. The following proe,rom is a different way to get a roin- 
baw of colors. Since there are a number of lines that are similar (40 
1 ] 0) use the editing keys to save a lot of typing. See the nates after the 
listing tc refresh your memory on the edi-fng orocedures 



HEW 



1 REI1 
5 PR I 
IS PR 
£0 CL 
38 OH 
46 PR 
•50 PR 
60 PR 
70 PR 
80 FR 
S0 PR 
180 P 
I 10 P 



fHUTOrlflTIC: COLOR BPIR5 
NT CHR*<147> : REN CHR*<14f*>» CLRVHOME 
INT CHR*<i8j'i " " ; :REM REVERSE BfHF: 

■ INT':S+RHD<1??+1 

CL GOTO 40^50^60, 70,80,90,180., 1 If 
ChR*<3>j i SOTO 10 
Cm$<2Q}}'. GOTO 10 
GOTO 10 
GOTO 10 

goto le 

GOTO 19 
GOTO 10 
GOTO 10 



INT 
INT 
I NT 

INT 

INT 
INT 



CHRfC3B3 : 

CHK»C1443 

PINT CHR*C158>; ! 
RIHT CHR*U59?; s 
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Type lines 5 through 40 normally. Your display should look like this: 




EDITING NOTES 



Uss the CRSR-UP key to position the cursor on line dO. Then type 5 
over the 4 of 40, Next, use the CRSR-RIGHT key to move over to the 5 in 
trie CHR$ parentheses. Hit ^^J QQQjQ to open up a space and type 
'28'. Now |ust hit ^^^^J with the cursor anywhere on the line. 

The display should now look like -his: 



1 REN AUTOMATIC COLOR BARS 

5 PRINT CHft*<l47) ; REM CHR*0 4^> = CLFy'HOME 

ltf PRINT CHP*<160.r " " .- :RI 

20 CL = INT<S*:RHD«: i >> + l 

50 ON CL GO TO 40 , S9 .r & , H > 86 j 3 1 3 , 1 O & r 1 1 

50 PRINT CHP*<;28;Vfi GOTO iff 



Don't worry, Line 40 is still there. LIST the program and see. Using the 
same procedure, continue to modify the last line with a new line number 
ond CHR$ code until all the remaining lines have been entered. See, we 
told you the editing keys would come in handy. As o final check, list the 
entire program to make sure all the lines were entered properly before 
you RUN it. 

Here is a sho-t explanation of what's going OH. 

You've probably figured out most of the color bar program by now 
except for some strange new statement in line 30. But let's quickly see 
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what the whole program actually does. Line 5 prints ths CHR$ code for 
CLR/HOME. 

Line 10 turns reverse type on and prints 5 spaces, which turn out to be 
o bar, since they're reversed. The first time through the program the bar 
will be ligit blue, the normal lext color. 

Line 20 uses our workhorse, the random function to select a r andom 
color between 1 and 8. 

Line 30 contains a variation of the IF . . . THFW statement which is 
called ON . . , GOTO. ON . . . GOTO allows the program to choose 
from a list of line numbers to go to. If the variable (in this case CL) has a 
value of I, the first line number is the one chosen (here 40). If the value 
is 2, the second number in the list is used, etc. 

Lines 40 110 just convert our random key colors to the apprupriule 
CHR$ code for that color and return rhe program to line 10 to PRIN" a 
section of the bar in that color, Then the whole process starts over 
again. 

See if you can figure out how to produce 16 random numbers, ex- 
pand ON . . . GOTO To handle them, and add the remaining CHR$ 
codes to display the remaining 8 colors. 

PEEKS AND POKES 



No, we're not talking about jabbing the computer, but we will be able 
to "look around" inside the machine and "slick" things In There, 

Just as variables could be thought of as a representation of "boxes" 
within the machine where you placed your Information, you can also 
think of some specially defined "boxes" within the computer that repre- 
sent specific memory locations. 

The Conrmadore 64 looks at these memor/ locations to see what the 
screen's background and border color should be, what choracters are to 
be displayed on the screen — and where — and a host of other tasks. 

By placing, "POKEing," a different value into the proper memory lo- 
cation, we can change colors, define and move cbjects, and even 
create music. 

These memory locations could be represented like this; 



53280 
X 



53281 
Y 



53282 



53283 



BORDtR 
COLOR 



BACKGROUND 
COLOR 
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On page 60 we showed just four locations, two of which control the 
screer and background colors. Try typing this: 

POKE 53261 ,7 ESI 

The background color of the screen will charge to yellow because we 
placed the value 'T — for yellow — in the location That controls the 
background color of the screen. 

Try POKEing different values Into the hocltg round: color location, and 
see wha' results you get. You con POKE any value between and 255, 
but only through 15 will work. 

The actual vakes to POKE for each color are: 






BLACK 


8 


ORANGE 


1 


WHITE 


9 


BROWN 


2 


RED 


10 


Light RED 


3 


CYAN 


11 


GRAY 1 


4 


PURPLE 


12 


GRAY 1 


5 


GREEN 


13 


Light GREEN 


6 


BLUE 


14 


Light BLUE 


7 


YELLOW 


15 


GRAY 3 



Can you think of a way to display the various background and border 
combinations? The -ollowing may be of some help: 



10 FOR BH = TO 15 

20 FUK' EO = @ TO 1 

38 POKE 532B0> Bfl. 

40 POKE 53281 .r BO 

50 FOR X = 1 TO 2060 ; NEXT 

60 NEXT BO: HEXT Bft 




Two simple loops were set up to POKE various values to change the 
background and border colors. The DELAY looo in line 50 just slews 
things down a bit. 
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For the curious, try: 
? PEEK (53280) AND 15 

You should get a valje of 15. This is the last value BORDER was given 
and makes sense because both the background and border colors are 
GRAY (value 15) after the program is run. 

By entering AND 15 you eliminate all other values except 1-15, be- 
cause of the way color codes are stored in the computer. Normally you 
would expect to find the same value that wns Inst POKEd in the location. 
In general, PEEK lets us examine a specific location and see what value 
is presently there. Can you think of a one line addition to the program 
that will display the value of BACK and BORDER as the program runs? 
How about this: 

25 PRINT CHR$(1471; "BORDER = " ; PEEK (53280) AND 15, "BACK- 
GROUND = " ; PEEK (53281) AND 15 



SCREEN GRAPHICS 

In all the printing of information that you've done so far, the computer 
normally handled information in a sequential fashion: one character is 
printed after the next, starting from the current cursor positiun (except 
where yoj asked for a new line, or used the ',' in PRINT formatting). 

To PRINT data in a particular spot you can start from a known place 
on the screen and PRINT the proper number of cursor controls to format 
the display. But this takes program steps and Is lime consuming. 

Bur just as there are certain spots in the Commodore 64's memory to 
control color, there are also locations that you can use to directly control 
each location on the screen. 



SCREEN MEMORY MAP 

Since the computer's screen is capable of holding 1000 characters (.40 
columns by 25 lines) there are 1000 memory locations set aside to han- 
dle what is placed on the screen. The layout of the screen could be 
thought of as a grid, with each square representing o memory location. 

And since each localien in merrnry can contain a number from to 
255, there are 256 possible values for each memory location. These 
value; represent the different characters the Commodore 64 can display 
(see Appendix E), By POKEing tne value for a character in the appra- 
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priate screen memory location, that character will be displayed in the 
prop&r position. 



COLUMN 
20 



39 

10S3 
t 



1924- 

iom 

110' 
[Hi 

:;s- 
1224 

mi 
.m 
:34' 

138< 

Mi 
l«4 
1504 
\bV. 
:i!H 
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Screen memory in the Commodore 64 normally begins at memory 
locaton 1024, and ends at location 2023. Location 1024 is the upper left 
corner of the screen. Location 1025 s the position of the next character 

to the right of that, and SO on down the row. Location 1063 is the 
right-most position of the flrsl row. The nest location following the last 
character on a row is the first character ot the next row down. 

Now, let's say that you're controlling a ball bouncing on the screen. 
The ball is in the middle of the screen, colLmn 70, row 13. The formula 
for calculatior of the memory location on the screen S: 



POI NT 



1024 + X 4- 40* Y- 



where X is the column and Y is the row. 

Therefore, the memory location of the ball is; 



1024 + 20 4- 480 or 1524 



COLLMN 
ROW (*0- It) 



6-3 



C ear the screen with 



and yjjjjmjjjg and type: 



POKE 1524,81 
POKE 55796,1 



-coio 

LOCATION 



COLOR MEMORY MAP 

A boll appears in the middle of the screen. You have placed a char- 
acter direclly inlu screen memory willioul using ihe PRINT statennent. 
The ball that appeared was white. However there is a way to change 
*he color of an object on the screen by altering another range of mem- 
ory. Type 

POKE 55796, 2 ~ 

The ball's color changes to red. For every spot on the Corrmodore 64's 
screen there ore two memory locations., one for the chcracter code, and 
the other for *he color code. The color memory map begins at loca-ion 
55296 (top lefl-hand corner), and continues on for 1000 Iccalions. The 



;olumn 

23 



5529C- 

55336 

55376 

55416 

55456 

55496 

55576 
55616 
55656 
55655 
55736 
55/76 
55*18 
55(56 
55S36 
5S936 
5S9?E 
56016 
560J6 

56036 

sens 
561 re 

56216 
562J& 



55335 



-I _ t~ ; 

— i— j — i — i — i_ . ~ 



K 



f 

56295 
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same color codes, from 0-15, that we used to change border and 

ocic kg. round colors cnn be user) here to directly change character colors. 

The formulo we used for caleoleting screen memory locations can be 

modified to give the locations to POKfc color codes, (he new formula is: 

COLOR PRINT = 5529d - X + 40*Y 



MORE BOUNCING BALLS 

Here's a revised bouncing ball program that prints directly on the 
Screen with POKEs, rather than using cursor controls wi'hin PRINT state 
rnenTs. As you will see afier running the program, it Is much more flexi- 
ble tnan the earlier prog'am, and will lead up to programming much 
more sophisticated animation. 

NEW 

10 PRINT "{CLR/HQME}" 

20 POKE 5328®,? : POKE 53281,13 

3@ X = 1 s V ■ 1 

40 DX ■ 1 : DV = 1 

50 POKE 1024 + X + 40*7,31 

£G FOR T - 1 TO IS : NEXT 

76 POKE 1324 + X + 49*V,32 

se X = X + DX 

30 IF X < = OR X > = 39 THEN DX = -DX 

100 V = V + DV 

110 IF V < = OR V ■> = 24 THEN DV = -DV 

120 GOTO 59 

Line 10 clears the screen, and line 20 sets the background to light 
r. n, sen with a yellow/ border 

The X and V ya-iables in line 30 keep track of the current row and 
column position of the bal. The DX and DY variables in line 40 are the 
horizontal and vertical direction of the bell's movement. When a +1 is 
added to the X value the ball is moved tn the right,- when — 1 is added, 
the ball moves to the left. A +1 added to Y moves the ball down a row; 

a -1 edded to Y moves the ball jp a row. 

Line 50 puts the bell on the screen at the current cursor position. Line 
60 is the familiar delay loop, leaving the ball on the sc r een just long 
enouyh tc see it. 

Line 70 erases the ball by putting a space (code 32) where the ball 
was on the sceeri. 
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Line 80 adds the direction fcujlcr lo X. Line 90 tests to see if the ball 
has reached one of the side walls, reversing the direction if there's a 
bounce. Lines 100 and 11C Co the same tning for *he top find botton 
walls. 

Line 120 sends the program back to displuy und mcves the ball 
again. 

By changing the code fr> line 50 from 81 to another character code, 
you can change the hall to any other character. If you chargs DX or DY 
to the boll will bounce straight insteac of diagonally. 

We can also add a little more intelligence. So ■'ar the only thing you 
cheeked for is the X and Y values getting cut o- bounds for the screen. 
Add the followirg lines to the program. 



21 FOR L - l to 10 ,^-f STRFFN PflDF 

25 POKE 1024 + IHT;RHD<1>*1000>, l£e'~^ Q '' n - L " 

27 NEXT L 

S5 IF PEEK<1024 + X + 4Q*V> - 166 THEN DH = -DX; 

GOTO 89 
103 IF PEEKCie2:4 + X t 40*Y> = 166 THEN DY = -UV i 

ooto ia e 

Lines 21 to 27 put 10 blocks on the screen in random positions. Lines 
85 and 105 check (P:EK) to see if the ball is, about to bounce into a 
block, ond changes the ball's direction if so. 
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INTRODUCTION TO SPRITES 

In previous chapters dealing with graphics, we sow that graphic 
symbols cauld bo used n PRINT stotements to create anima-ioi and add 
chart'ike appearances ro our displays. 

A way was also shown to POKE character codes in specific screen 
memory locations. This would then place the appropriate characters di- 
rectly on ;he screen in the right 3pot. 

Creating animation in both these cases requires a lot of work because 
objects must be created from existing graphic symbols. Moving the ob- 
ject requires a number of program statements to keep track of the ob- 
ject and move it to a new spot. And, because of the limitation of using 
grophk symbols, the shape and resolution of the object might not be as 
good as required. 

Using sorites in anirrated sequences eliminates a lot af these prob- 
lems. A spr'ts is a high-resolution programmable object that con be 
made into Just uboul uny shape — through BASIC commands. The ob|ect 
car be easily moved cround the screen by simply telling the computer 
the position the sprite should be moved to. The computer takes care of 
the rest. 

And sprites nave much more power than just that. Their color can be 
changed; you can tell if one object collides with another; they can be 
made to go ir front and behind another; and they can be easily ex- 
panded in size, just tor starters. 

The penalty for all this is minima'. However, using sorites requires 
knowing some more details abour how the Cornmodo'e 64 operates and 
how numbers are handled witnin the computer. It's not as difficult as H 
sounds, though. Just follow the examples and you'll be making your own 

sprite$ do amozhg things in no time. 

SPRITE CREATION 

Sprites are controlled by a separate picture-maker in the Commodore 
64. This picture maker handles the video display. It does all the hard 
work of creating and" keeping track of cha-acters and graphes, creating 
colors, and moving around. 

Tiis display circuit has 46 different "ON/OFF" locations which act like 

Internal memory locations. Each of these locations breaks down into a 
series of 8 blocks. And each block can either be 'on" or "off". We'll get 
into more detail about this later. By POKEing the appropriate decimal 
value in the proper memory location you can control the formation and 
movement of your sprite creations. 
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In addition to accessing many of the picture making locations we will 
also be using some of the Commodore 64's mail memory to store infor- 
mation (data) tha* defines the sprites. Finally, eight memory locations 
directly after the screen memory will be used fo "el! the computer exactly 
which memory area each sprite will get its data from. 

As we go through some examples, the process will be very 
straightforward, and you'll get the hang o £ it. 

So let's get on with creating some sprite graphics. A sprite object is 24 
dots wide by 21 dots long. Up to eight sprites can be controlled at a 
time. Sprites are displayec in a special independent 320 dot wide by 
200 dot high area. However, you can use your sprite with any mode, 
high-resolution, low-resolutior, text etc. 

Say you want to create a balloon and have it flual around 'he sky. 
Ihe balloon could be designed as in the 24 by 21 grid on page 70. 

The next step is to convert the graphic design into data the computer 
can use. Get a piece of notebook or graph paper and set up ci sample 
grid that is 21 spaces down and 24 spaces across. Across the top write 
1 2B, 6-4, 32, 16,8,4,2,1 , three times (as shown) for each of the 24 
squares. Number down the left side of the grid 1-21 for each row. Write 
the word DATA at the end of each row. Now fill in the grid with any 
design or use the balloon that we have. It's easiest to outlire the shape 
first and then go back and fill in the grid. 

Now if you "hhk of all the squares you nlled in as "on" then substitute 
a 1 for each filled square. For the one's that aren't fillec in, they're "off" 
so put a ze'o. 

Storting on -he first row, you need to convert the dots into three sepa- 
rate pieces of data the computer can read. Each set of 8 squares Is 
equal to one piece of data called a byte in our balloon. Working from 
the left, the first 8 squa-es are blank, or 0, So the value for that series of 
numbers is 0. 

The middle series Icoks like this iagain a 1 indicates a dot, is a 
space): 

128 64 32 16 8 4 2 1 



L? l. l _1 I i h 1 i h 



+ 64 +32 + 16+ 8+4+ 2+1= 127 

The third series on the first row also contains blanks, so it, too, equals 
iero. Tius, Ihe data for the first line is; 

DATA 0, 127, 
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SERIES 
1 



SERIES 
2 



SERIES 
3 
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■■'• 


2 


; 
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COLUMN 



20 



24 



The series. that make up row two are calculated like this 
Series 1 : 

Secies 1. 
























1 








1 


1 


1 


1 


1 


1 


1 


1 


1 



t T T 

128 +64 +32 



T T 

16 + 8 



t r t 

4+2+1 



255 



Series 3; 



1 1 


o o o o c 






T 1 

128+64 



= 192 



For row 2, the data would be; 

DATA 1,255,192 

In the some way, the three series tTat mgke up each remaining row 
would be converted into their decimal value. Take the time To dc the 
remainder of the conversion in tUs example, 

Now that you have the data for your object, how can it be put to use? 
Type in the -following program and sec what happens. 
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J REM UP, UP.. FND RWRV! 

5 PRINT '■{CLR/HOME} 11 

1G V= 53248 : REM STRRT OF DISPLflV CHIP 

11 POKE V+21,4 i REM ENRBLE SPRITE 2 

12 POKE 2842,13 t REM SPRITE 2 DATA FROM 13TH BLK 
20 FOR H = TO 62i RERO Q i POKE 332+N,Gs NEXT 
30 FOR X = TO 203 ^ sets ts info, from o»ta* 

40 POKE V+4,Xi REM UPDATE X COORDINATES 
50 POKE V+5,X: REM UPDATE V COORDINATES 
S0 NEXT M 

70 GOTO 3fl,^INFO "EiDINFROWO* 

200 DflTfl"^, 127, 0,1, 255, 192, 3, 255, 224, 3, 23 1,224 

210 OflTfi 7,217,240,7,223,240,7,217,240,3,231,224 

220 OfiTR 3,255,224,3,255,224,2,255,160,1,127,64 

230 DRTR 1,62,64,0,156,128,0,156,129,0,73,9,0,73,0 

240 DflTfl 0,62,0,8,62,0,0,62,0,0,28,0 

-fOR MORI DETAIL ON READ * DATA SEE CHAPTER B, 

If you typed everything correctly, your balloon it smoothly flying 
across the sky (page 72). 

In order x> understand whgt happened, first you need to know what 
picture rooking locations rmtrol the? -unctions you need. These locations, 
colled registers, could be illustrated in this manner: 

Regi'srer(s) Description 

X coordinate of sprite 

1 Y coordinate of sprite 
2—15 Paired like rind 1 for sprites 1-7 

16 Most Significant Bit — X Coordinate 

21 Sprite appear: I =appear 0=disappear 

2° Expand sprite in "X" Direction 

23 Expand sprite in "Y" Direction 

39 - 46 Sprite 0-7 color 



In addition to this information you need to know from which 64 byte 
section spri-es will get their cata (1 byte is not used). 

This data is handled by 3 locutions directly after screen memory: 



204 | 41 



42 



43 



44 



45 " ! 46 | 2047 
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r 
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r 


t 


t 


t 


SPRITE 


i 


2 


3 


4 


5 


6 


7 



Now let's outline the exact procedure to get things moving and finally 

write a program. 
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AC1JAL SCREEN EHOtO 



There are only a few "hlngs necessary to actually crsate and move an 
object. 

1. Moke the proper sprilefs' appear or: I lie streen by POKEing into lo- 
cation 21 o 1 for the bit which turns on the sprite. 

2. Set sprite pointer (locations 2040-7} to where sprite dato should be 
read from. 

3. POKE cctual dcita into memory. 

4. Through a loop, update X and Y coordinates to move sprite around. 

5. You can, optionally, exoand the object, change colors, or perform a 
variety of special f jnr:tions_ Using location 29 to expand your sprite in 
the "X" direction and location 23 in the "Y" direction, 

There are only a few items in tie program that might not be familiar 

from the? discussion £C far. 

In line 10; 

V=53248 
sets V to the starting memory location of the video chip. In tnis way we 
just increase V by the memory number to get the actual memory loca- 
tion. The register numbers are the ones giver on the sprite register mop. 
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In line 1 1 , 

POKE V+21,4 
makes sprite 2 appear by placing a 4 in whaf is called rhe sprite enable 
register (21) to turn on spriie 2, Think of it like this: 



Decimal *ata<s of each 
sprite number 




, Sprite Lewi Number 



21 



1 



-4 



Put 3 1 For Th« SPRITE Yog Wont 

Each sprite level is represented in section 21 of the sprite memory and 
4 happens to be sprite level 2. If you were using level 3 you would put a 
1 in sprite 3 which has a value of 8, In fact if you used both sprites 2 
and 3 you would put a 1 in both 4 and S. You would then add the 
numbers together just like you did with the DATA on your graph paper. 
So, turning on sprites 2 and 3 would be represented as V+2l,l2. 

In line 12; 

POKE 2042,13 
instructs the computer to get the data for sprite 2 (location 2042) from 
the 13th area of memory. Ycu know from making your sprite that it 
takes up 63 sections of memory. You may not have realized it, but those 
numbers you put across the top of your grid equal what is known as 3 
bytes of the computer, tn other words &ach collection of the following 
numbers, 128,64,32,16,8,4,2,1 equals 1 byte of computer memory. 
Therefore with the 21 rows of your grid times the 3 bytes of each row, 
each sprite *akes up 63 bytes o ( memory. __ , WH ole smite 

20 FOR N = to 62i READ ofl»OKE 832+N,Q; NEXT 

This line handles the actual sprite creation. The 63 bytes of data that 
represent the sprite you erected are READ in through the loop and 
POKEd into the 13th block of memory. This starts at location 832. 

30 FOR X = Z TO 230 ^ 

40 POKE V + 4'X ■ — fsPHTTEzTrfoOKJINfi I h ^ 

5 POKL v" + 5,X ^^-@RFillLCCORDiNAT=\ 

If you remember from sciool the X coordinate represents an objects 
horizontal movement across the screen and the Y coordinate represents 
the sprite's vertical movement across the screen. Therefore as the values 
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of X change in line 30 from to 200 (one number at a time) the sprite 
moves across the screen DOWN and TO THE RIGHT one space for each 
number. The numbers are READ by the computer fast enough to make 
the movemeit appear to be continuous, instead of 1 step at a time. If 
you need more details take a look at the reglste' map in Appendix O. 

When you get into moving multiple objects, it would be impossible for 
one memory section to update the locotions of all eight objects, There- 
fore each sprite has its own set of 1 memory sections to make it move on 
the screen. 

Line 70 starts the cycle over aga n, after one pass or the screen. The 
remafnder o^ the program is the data for the balloon. Sure looks differ- 
ent on the screen, doesn'" it? 

Now, try adding the following line; 

25 POKE V + 23,4 -. POKE V4-29 ,A- REM EXPAND 

and RUN the program again. The balloon hos expanded to twice the 
original siie! What we did was simple. By POKE ng 4 (again to indicate 
sprite 2) into memory sections 23 anc 29, sprite 2 was expanded in the 
X and Y direction. 

It's important to note that the sprite will start in the upper left-hand 
corner of -he object. When exoanding an object in either direction, the 
starting point remains tne same. 
For some added excitement, mcke the following changes: 

11 POKE V+21,12 

12 POKE 2042,13 -. POKE 2043,13 
30 FOR X = 1 to 1 90 

45 POKE V+6,X 
55 POKE V+7,l?0-X 

A second sprite (number 3) has been turned on by POKEing 12 into the 
memory location tha* makes the Sprite appear (V + 21). The 12 turns 
sprites 3 and 1 on (00001100 — 12). 

The added lines 45 and 55 move sprite 3 around by POKEing values 
into sprite 3 J s X and Y coordinate locations (V+6 and V+7). 

Want to fill the sky with even more octior? Try making these addi- 

t>0m ' (28*7$ RiALLY ""{.(SPRITE 2) + 6) 

_____J (SPRITE 3) + 16 (SPRITE 4) ) 

11 POKE V+21, 28~— y ■ ' 

12 POKE 2042,13iPOKE 2043, 13: POKE 2044,13 
25 POKE V+23,12 ; POKE V+29,12 

4B POKE V + 8.X 
5B POKE V+9,100 
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■ n line 1 1 this time, another sprit© (41 was made to appear by POKE- 
ing 28 iito the appropriate "on" location of the sprite memory section. 
Mow sprites 2-4 are on (0001 1100 = 28}. 

Line 12 indicates that sprite 4 will get its data from the same 
memory area (13th 63 section area) as the other sprites by POKEing 
2044,13. 

In line 25, sprites 2 and 3 are expanded by POKting 12 (Sprites 2 
end 3 on) into the X and Y direction expemdec memory locations (V+23 
end V + 29). 

Lin« 43 moves sprite 3 olong the X ax's. Line 50. positions sprite 3 
halfway down the screen, ct location 100. Because this value does not 
change, like it did before with X=0 1o 200, sprite 3 just moves horizon- 
tally. 

ADDITIONAL NOTES ON SPRITES 

Now that you've experimented with sprites, a few more words are in 
order. First, you can change a sprite's color to an/ of the standard 16 
color codes (0-15) thct were used to change character color. These can 
he found in Chapter 5 or in append* G. 

For example, to charge sprite 1 to light green, type: POKE 
V+40,T3 (be sure to set V = 53248). 

You ma/ have noticed in using the example sprite programs that 
the object never moved to the right-hand edge of the screen. This was 
because the screen h 320 dots wide and the X direction register can 
only hold a value up to 255. How then can you get an object to move 
across tie entire screen? 

There is a location on the memor/ map that has not been men- 
tioneo yet, Location 16 (of the map) controls something called the most 
significant bt (MSB) of the sprite's X direcion location. In effect, this 
allows you to move the sprite to o horizontal spot between 256 and 320. 

The MSB of X register works like this: after the sprite has been 
moved to X location 255, place a value into memory location 16 repre- 
senting the sprite you want to move. For example, to get 2 to move to 
horizontal loca-ions 256-320, POKE the value for sprite 2 which is (4) into 
memory location 16: 

POKE V+16,4. 

Now start from again in the usual X direction register for sprite 2 
(which is in location 4 of the map). Since you are only moving another 64 
speces, X lorfifions would onl/ -ange between ard 63 tnis time. 
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This whole concept Is best illustrated wiTh a version of the original 
sprite 1 program: 



10 V= 3 3.2148: POKE 7+2:1^4 : POKE 2042^13 

20 FOR N - 8 TO 62 : READ Q : POKE 332t-N,Q ! NE>CT 

25 POKE V + 5.. 10B 

30 FOR K = 6 TO £55 

40 POKE V+4,K 

50 HEMT 

CO POKE V+16,,4 

70 FOR K — TO S3 

SO POKE V+4, M 

90 NEXT 

100 POKE V+iS.,0 

110 GOTO 30 



Line 60 sen rlie most significant bi* for sprite 2. Line 70 starts moving 
tne standard X direction location, moving sprite 2 the resl of the way 
across the s:reen. 

Line ]00 is important because it "turns off" the M5B so l rial the 
sprite can start moving from the left edge of the screen again. 

To define multiple sprites, you may need additional blocks for the 
Sprite data. You can use some of BASiC's RAM by moving BASIC Refore 
typing or loading your program type: 

POKE44, 1 5:POK£16*256,0:NEW 

Now, you can usa blocks 32 throjgh 41 (locations 2048 through 4095) to 
store sprite data. 

BINARY ARITHMETIC 

It is beyond the scope of this introductory manual to go into details of 
haw the computer handles numbers. We will, however, provide you with 
a good base for understanding the process and get you started on 
sophisticated animation. 

But, before you get too involved we have to define a few te r ms: 

BIT — This is the smallest amount of information n computer can store. 
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Think cjf u BIT us a switch that is either "on" or "off". When a BIT is 
"on" it has a value of 1; when a BIT is "ott" it has a value of 0. 

After BIT, the next level is BYTE, 

BYTE — This is defined as a series of BITS, Since a BYTE is made up of 
8 BIT5, you can actually have a total of 256 different combinations 
of BITS. In other words, you can have ail BITS "off" so your BYTE 

will Icots like this: 



128 



64 



I 



22 



i 



16 



I 



1 



J 







and its value wtl 
128 64 



be 0. All BITS "on" is: 



32 



14 



: 



i 



z 



i 



i 



which is 128+64+32+16+8+2+1=255. 
The next step up is called a REGISTER. 

REGISTER— Defined as a block of BYTES strung together. But, in this 
case each REGISTER is really only 1 BYTE long. A series of REGIS- 
TERS mukes up a REGISTER MAP. REGISTER MAPS are charts like 
the one you looked at to make your BALLOON SHKUt. fccch KfcGlS- 
TER controls a different function, like turning on the SPRITE is really 
cnllerJ the FNABLF RFGISTFR. Making the SPRITE longer is the EX- 
PAND X REGISTER, while making the SPRITE wider is the EXPAND Y 
REGISTER. Keep in mtnd thct a REGISTER Is a BYTE that performs a 
specific task. 

Now let's move on to the rest of BINARY ARITHMETIC. 
BINARY TO DECIMAL CONVERSION 



12B 


64 


32 


16 


timul Va 
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1 
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□ 














1 
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Using, combinations of ull eiyht bits, you (.tin obtain any decimal value 
f r om to 255. Do you start to see why when we POKEd character or 
color vcluss into rrernory locations the values had to be in the 0-255 
range? Each memory iccotion can hold a byte of information 

Any possible combination of eight 0's and l's will convert to a 
unique decimol value between 0-255. If all places contain a 1 then the 
value of *he byte equals 255. All zeros equal a byte value of zero; 
'0000001 1" equals 3, and so on. This will be the basis for creating dato 
that represents sprites and manipulating them. As just ore example, if 
this byte grouping represented pert of a sprite (0 is a space, 1 is a 
colored area): 

2 7 2 & 2 5 2 4 2 3 2 £ 2 1 2° 



DZL 



I 



I 



64 - 32 4 



8 + 



Then we would POKE 255 nto the appropriate 
represent that part of the object. 



2 + 1 + =255 

emory locction to 



TIP: 

To save you 'he trouble :>f converting binary numbers into decimal values — we'll 
reed To do thcr a lot — the fallowing program will do the work for you. It j s a gcod 
ideO to enter and save the program rpr fyj'ure u&e. 

5 REM BIHRRV TO DECIMOL CONVERTER 

10 INPUT "ENTER 8-BIT BINARY NUMBER :";FW 

12 IF LEN <Tfl*> <> e THEN PRINT "8 BITS PLEASE..."! 

GOTO 10 
15 TL - 3 : C = 

20 FOR H = 8 -bo 1 STEP -1 : C = C + 1 
30 TL = TL + ««fflL<«IDf<ft* ( rC,i>>*2|<K-i) 
40 NEXT X 

50 PRINT ft*;" BIHRRV " ; " = "?TL;" DECIMRL" 
50 GOTO 10 

This program take; your binary number, which was entered as a string, and looks 
ct each characer of the string, from left to right (the MIDS Knctior). The variable C 
indicates what character to work on as the progran goes through the loop. 

The VAL function, in line 30, returns the actjal vclue of the choracte'. Since we 
ore dealing wi'h numeric characters, the voice is the some as the character. For 
example, if the first character of A$ is 1 then the value would olso be 1 . 

The -"incl par of lire 30 multiplies the voke of the current character by ths proper 
power of 2. Since the first value is in the 2*7 place, in the example, TL would first 
equal I times ]2S or 128. If the bit is, then the value For that place woulo also be 
zero. 

This process is repeated for all eight characters at TL keeps *rock of the running 
total decinal value of the ainary number. 
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CHAPTER 



CREATING SOUND 



• Using Sound if You're Not a Computer- 
Progrommer 

Structure of o Sound Program 
Sample Sound Program 
Making Music on Your Commodore 64 
Important Sound Settings 
Ploying a Song on the Commodore 64 
Creating Sound Effects 
Sample Sound Effects to Try 



USING SOUND IF YOU'RE NOT A COMPUTER 
"PROGRAMMER" 

Most programmers use computer sound for two purposes: making 
music and generating sound effects. Before getting into the "intricacies" 
of programming sound, let's take □ quirk look nt how a typirnl sound 
program is structured . . . and give you a short sound program you can 
experiment with, 

STRUCTURE OF A SOUND PROGRAM 

To begin with, there are five settings which you should know in order 
to generate sound on your COMMODORE 64: VOLUME, ATTACK/' DE- 
CAY, SUSTAIN/RELEA$E(AD5R), WAVEFORM CONTROL and HIGH 

FREQUENCY/LOW FREQUENCY. The first three settings are usually set 
ONCE at the beginning of your program. The high and low frequency 
settings must be set for EACH NOTE you play. The waveform control 
starts nnd stops each note. 



SAMPLE SOUND PROGRAM 

Before you start you have fo choose a VOICE. There are 3 voices. 
Each voice requires different sound setting numbers for Waveform, etc. 
You car ploy 1, 2 or 3 voces togelher hut our snmplfi uses only VOICE 
NUMBER 1. Typ« in this program lire by line . . . bg sure to hit the 
RETURN key after ea = h line: 
First clear sound chip. 

1. Set VOLUME at highest setting, 

2. Set ATTACK/DECAY rates to 
define how fast a note rises to and 
falls from its peak volume level (0 
TO 255). 

3. Set SUSTAIN/RELEASE to define 
level to prolong note and rate to 
relecse it. 

4. Find trie note/tone you want to 
play in the TABLE OF MUSICAL 
MOTES in Appendix M and enter 
the HIGH-FREQUENCY and LOW- 
FREQUENCY values for that note 
(each note requires 1 POKEs). 



5 FORL=54272T054296; 

POKEL,0:NEXT 

IE POKE542?6,15 

22 POKE54277,190 



32 POKE 54278,248 



40 POKE54273,17:POKE54272,37 



so 



5. Start WAVEFORM with one of 
4 standard settings (17, 33, 65 
or 129). 

6. Enter a time loop to set the 
DURATION of the note to be 
ployed (c quarter note is Opprox. 
'250' but may vary since a longer 
program can affeul ihe liming). 

7. Turn off note. 



50 POKE54276,17 



63 FORT- 1T025«;N EXT 



70 POKE54276,16 



To hear the note you just created, type the word RUN and then hit the 
D2]]]]JJ| fcey. To view the prograrr type the word LIST and hit | 
To change it, retype the lines you want to aller. 



MAKING MUSIC ON YOUR COMMODORE 64 



You con't have to be a musician to make music on your COMMODORE 
64J All ycu need to know are a few simple numbers which tell your 
computer how loud to set the vourne, which notes to pay, how long to 
play them, etc. But first . . . here's a program which gives you a quck 
demonstration of the COMMODORE 64's incredible music capabilities, 
using only ONE of your computer's 3 separate voices. 

Typp the word NEW and hit | j . .; | to erase your previous pro- 
gram, then enter thi& program, type fhe word RUN and h"t the | 

key. 



5 REM MUSICAL SCALE* ™- »< '■»•"»■ 

7 FQRL=54272T0542°6: POKE 1,0, NEXT 

10 POKE 54296, \5< S*s voluma or highail letting Oi) 

20 POKE 54277,9* 



30 POKE 54276, 17* 

40 FORT=TTO300:NEX1< 
50 READ A* 



_ Se1s Attack/Decay 
Su^ajr/Rclcass level 'each note) 

- 1>« le rrm ri «i wnnfetarm l+yp* or jovndji 

-Duration (how long) #3ch nots play*, 

- B«<-oH firtt tilt*!**' 3 rt Hn. 1 TO DATA. 
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60 READ B«- Bgt , dl j.tond „ um i,. r i„ ii„ e no data. 

70 IFB = -1THENEND « !ENDS „„ EADs _, ^,, ww . 

80 POKE 54273,A : POKE54272,B< ■ poke, th. u ^ i.™ data .„h., IW( *. ,„ 

otHHJH fBECueucVond mend ~»r~t.r (6-37) 
a* LOW FREQUENCY. M»Kt timfr picgrem loops 
around it BEADS A as 19 and Q as 63, old Jo on, 
and POKEi thine rumbtr* into the HIGH and IOW 
PRECtUEMCV Eeccrtfont. The numbtr M373— HUSH 
FMOUSNCY far VqICet and 3i27I = LUW PHE- 

OUENCr for voice;. 

85 POKE 54276,17* start™*. 

90 FORT = 1TO250! NEXT, POKE54276, 16 t* « P ia, rt-„ „ op „«. 

95 FORT = 1TO50:NEXT «- t,™ fo, „ie„ e , 

100 GQTQ20 < lo »P 3 batk " ">"*' CONTItOL and slaj mw note. 

1 1 0,i DATA 17, 37, 19, 63, 21 ,154,22,227 H,ii ™ | ™ , « wi»«i™iMt»«ig.ena#i«Ai^i)jh[ 

120 DATA25,1 77,28,214,35,94,34, 1 75 I* 5<K* poiref • uaMrirBprntirrictrM note, lor 

■xampln. 17 and 37 ^(vwnl "I ^f In* 4lh a,. 
love. If and 03 rfrp-ftienr "D" and to on. 

900 DATA - ],— 1< WUn program nadni -I it tui-ni off HIGH'LQW 

FREQ.LENCY ietllnai and ENDS at instructed in 
lilH 74. 



To change the sound to a "harpsichord," change Lire 85 to rend 
POKE54276,33 and Line 90 to read FORT = lTO250;NEXT;POKE54276,32 
and RUN the program again. (To change the line, hit the ^Q^Q key 
tc stop the program, type the word LIST and hit(^. ■ J then retype 
the program line you want (o change; the new line will automatically 
replace the old one). Whar we did here is change the "waveform" from 
a "triangular" shaped sound wove 'o a "sawtooth" wave. Changing the 
WAVEFORM can drastically change the sound produced by the COM- 
MODORE 64 . . . but . . . waveform s only one of several settings you 
con change to make different musical Tones and sound effects! You can 
also change the ATTACK/DECAY rate of each note . . . for example, to 

change from n "harpsichord" sound to a more "banjo" sound try chang- 
ing lines 20 and 30 to read; 

20 POKE54277,3 

30 POKE54278,0 <— — set. ,» »„,«,!„ for ba„i«. »««,. 
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As you've just seen, you can make your COMMODORE 64 sound like 
different musical instruments. Let's take a closer look at how each sound 
setting works 

IMPORTANT SOUND SETTINGS 

1 VOLUME — To turn on the volume and set it to the highest level, type; 
POKE 54296,15. The volume setting ranges from to 1 5 butyou'll use 15 
most of the time. To turn "off" the volume, type: 

POKE 54296,0 

You ufily have to set the volume ONCC at the beginning of your pro- 
gram, since the same sefing activates al [ three of the Commodore 64's 
VOICES. (Changing the volume during a musical note or sound effect 
can produce interesting results but is beyond the scope of this introduc- 
tion.) 

2. ADSR and WAVEFORM CONTROL SETTING — You've already seen 
how changing the waveform can change the sound effect from 
"xylophone" to "harpsichord." Each VOICE has its own WAVEFORA^ 
CONTROL SETTING which lets you define four different types of 
waveforms: Triangle, Sawtooth, Pulse (Square) and Noise. The CON- 
TROL olso activates the COMMODORE 64's ADSR feature, but we'll 
come back to this in a moment. A sample waveform start setting looks 

like this: 

POKE 54276, 17 
where the first number (54276) rep-esents the control setting for VOICE 1 
and the second number (17} represents the start for a triangular 
waveform. The settings for each VOICE and WAVEFORM combination 
are shown in the table below. 



ADSR AND WAVEFORM CONTROL SETTINGS 





CONTROL 
REGISTER 


TRIANGLE 


htttt Start/ Slop Number* 
SAWTOOTH PULSE 


NOISE 


VOICE 1 


5427(5 


17/16 


33/32 


65/64 


129,' 128 


VOICE 1 


54283 


17/16 


33'32 


65/64 


12v,'128 


VOICE 3 


5429C 


17/16 


33/32 


65/64 


12V,' 128 



Although the control registers are different for each voice the 
waveform settings are the same for each type of waveform. To see how 
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this works, look gt Lines 85 and 90 in me musical scale program. In this 
program, immediatefy after setting trie frequency in Line 80, we set the 
CONTROL SETTING for VOICE 1 in Line 85 by POKEing 54276,17. This 
turned on the CONTROL for VOICE 1 and set it to a TRIANGLE 
WAVEFORM (17). In Line 70 we POKE 54276,16, stopping the note. La- 
ter, we cKanged ttie waveform start setting from 1 7 to 33 to create a 
SAWTOOTH WAVEFORM and this gave the scale a "harpsichord" effect. 
See how the CONTROL SETTING and WAVEFORM interact? Selling the 
waveform is similar to setting the volume, except each voice has its own 
setting and instead of POKEing volume levels we're defining waveforms. 
Next, we'll look at another aspect of sound . . . the ADSR feature. 

3. ATTACK/DECAY SETTING — As we mentioned b&fore, the ADSR 
CONTROL SETTING not only defnes the waveform but It also activates 
the ADSR, or ATTACK/ DECAY/SUSTAIN' RE LEASE feature of the COM- 
MODORE 64. We'll begin by looking at the ATTACK/DECAY setting. The 
fallowing chart shows the various ATTACK and DECAY levels for each 
voice. If you're not familiar with the concepts of sound attack and de- 
cay, you might think of "attack" as the rate at which a note/sound arises 
to its MAXIMUM VOLUME. The DECAY is trie rate at which the note/ 
sound falls from its highest volume level back to the SUSTAIN level. The 
following chart shows the ATTACK/DECAY setting for each voice, and the 
numbers for each attack and decoy setting. Note that YOU MUST 
COMBINE ATTACK AND DECAY SETTINGS BY ADDING THEM UP AND 
ENTERING THE TOTAL. For example, you can set a HIGH ATTACK rate 
and a LOW DECAY rate by acding the high attack number (64) lo the 
low decay number (1). The total (65) will fell "he computer to set the high 
attack rate and low decay rote. You can also increase the attack rates 
by adding them together (128 + 64 4- 32 + 16 = MAX. ATTACK RATE 
of 240). 

ATTACK/DECAY RATE SETTINGS 

ATTACK-DECAY HIGH MEDIUM LOW LOWEST HIGH MED. LOW LOWEST 
SETTING ATTACK ATTACK ATTACK ATTACK DECAY DECAY DECAY DECAY 



VOICE 1 


54277 


128 


64 


32 


16 


% 


4 


2 
2 


1 
1 


VOICE 2 


54284 


128 


64 


32 


Id 


8 
8 


4 
4 


VOICE 3 


54291 


128 


64 


32 


16 


2 


1 



If you set an attack rate with no decay, the decay Is automatically 
zero, and vice-versa. For example, if you POKE 54277,64 you set a 
medium attack rate with zero decay for VOICE 1 . If you POKE 54277,66 
you set a medium attack rate and a low decay rate (because 66=64 + 2 
and sets BOTH settings). You can also add up several attack values, or 
several decay values. For example, you can odd a low attack (32) and a 
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medium arrack (64) for a combined attack rate of 96, then add a 
medum decay of 4 and . . . presto . . . POKE 54277,100. 

At this point, a sample pmgrnm w ; lf oefter illustrate the effect. Type 
the word NEW, hit ^ ) and type n this program and RUN it; 

5 FOR L=54272TO54296 : POKEL,0;NEXT<— hath* «• mw =io,.. 

10 PRINT"HIT ANY KEY" « ■ s™ n m.™ 8 .. 

20 POKE54296,15< s«. ™i»™ „. u«m« imm. 

3D POKE54277,64 * — s.t Att«fcD. coy . 

40 POKE54273,T7:POKE54272,37<— Pst, ,,.,. „„,. into voice i. 

60 GETK$;IFK$="'THEN60 «— ch«k «,„ i^b-cd. 

70 POKES4276, 17iFORT = lTO200:NEXT< wufc-fawwiteja*™,!,* 

80 POKE54276, 16;FORT = 1TOS0:NEXT < r ur „ »« ,.tii„ B ,. 

90 G0TO2G < Loop bock and do it again. 

Here, we're using VOICE 1 to create one note at a time . . . with a 
MEDIUM ATTACK RATE end ZERO DECAY. The key h Line 40. POKEing the 
ATTACK/DECAY setting with the number 64 uctivutes u MEDIUM attack 
rate. The result saurds like someone bojncing a ball ir an oi drum. 
Now for the fun part. Hit the (2JJJEI33 key to stop the prog r am, then 
type the word LIST and hit | i J. Now type this line and hit | 
One new line 40 automatically replaces the old line 40): 

40 POKE 54277,19.3 



Type the word RUN and hit I I to see how it sounds. What we've 

done here is combine several attack and decay settings. I he settings 
are: HIGH ATTACK (128) + LOW ATTACK<32) + LOWEST ATTACK (16) 
-4- HIGH DECAY (8) + MEDIUM DECAY(i) + LOW DECAY(2) = 190. 
This, effetl suunds like a sound an oboe or other "reedy" instrument 
might make. If ycu'd like to experiment, try changing the waveform and 
aftcck/decay numbers in the musical scale example to see how an 
"obnft" sounds Thus . . . you ccn see that changing the atta-k/decay 
rates can be used to create different types of sound effects. 

4. SUSTAIN/RELEASE SETTING — Like Attack/Decay, the SUSTAIN/ 
RELEASE setting is activated by the ADSR/WAVEFORM Control. SUSTAIN/ 
RELEASE lets you "extend" (SUSTAIN) a pr>rtinn of a particular sound, like 
the "sustain pedal" on a piano or organ whiih lets you orolong a note. 
Any note or sound can be sustained at eny one of 16 evels. The 
SUSTAIN/ RELEASE Setting moy be used with a FOR . . . NEXT loop to 
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determine how long The note will be held at SUSTAIN volume before 
being rel&ased. The following chart shows the numbers you have to 
POKE to rench different SUSTAIN/RELEASE, rates. 



SUSTAIN/RELEASE RATE SETTINGS 

SUSTAIN. BEIEME W9H MEBIUM LOW lOWSSl HIOM WED. LOW LOWEST 

COntcol seTrlNQ Sustain sustain sustain sumn reiease release release jtEUiASE 



VOICE 1 


34Z7i 


liS 


64 


" '32 


16 


S 


4 2 


1 


VOICE 2 


S42&5 


126 


64 


32 


16 


3 


A 2 


1 


VOICE 3 


54292 


128 


64 


32 


16 


8 


A 2 


1 



As an exgrrple, if you're using VOICE1, you can set a HIGH SUSTAIN 
LEVEL by typing; POKE 54279,128 or you could combine a HIGH SUSTAIN 
LEVEL with a LOW RELEASE RATE by adding 128+2 and then POKE 
54278,130. Here's the same sample program we used in the ATTACK/ 
DECAY section above , . . with a SUSTAIN/RELEASE feature added. 
Notice the difference in sounds. 



5 FORL=54272T054296 : POKEL,CUNEXT 

10 POKE542S>6,13 « ■ 

20 POKE54277,64 * 

30 POKE54278,128< 



40 POKE54273,17:POKE54272,37 4 

50 PRINT"HIT ANY KEY" 4 

60 GETK$:IFK$=" "THEN60 4 

70 POKE54276,17:FORT=ITO20i3 : NEXT 4- 
80 POKE5427e,16=FORT=IT05&NFXT< — 
90 GOTO60 < 



-*Dnr"«fi»rt *h* n^»* plcyir 



" Sat Winn* at highest level. 
' S*1 AMotk.'D«oy. 
" 5*1 SuilftJM.'R*l*oi* 



"r<5«c vn* pox* into VOICE T. 
" Screen mt>t$tig». 
Chick the keyboard. 

~ Set V',-.vy |'i_i ii (Qntwl (" 'i.ny ly! 
"Tun •:■'-" s «■! I ' n =■.■: . 

" Lr>cp back and do [t gjgoin. 



In Line 30, we tell the computer to SUSTAIN the note at a HIGH SUS- 
TAIN LEVEL (128 from chart above] . . . after which the tone is released 
in Line 30. You can vary the duration of a rote by changing the "count" 
in Line 70. To see the effect of using ihe release function try changing 
Lint- 30 to POKE54278,89 (SUSIAIN = 80, RELEASE = 9). 

5. CHOOSING VOICES AND SETTING HIGH/LOW FREQUENCY 

SOUND VALUES — Each individual note on 'he Commodore 64 requires 
TWO SEPARATE POKE GOMA<VANDS . . . one for HIGH FREQUENCY and 
one for LOW FREQUENCY. The MUSICAL NOTE VALUE table in Appendix 
M shows you the corresponding POKEs you need to play any note in the 
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Commodore 64's eight octave range. The HIGH and LOW FREQUENCY 
POKE COMA1ANDS are different for each VOICE you use — this allows 
you to program all 3 voices independently to create 3-voice music or 
exotic sound effects. 

The HIGH and LOW FREQUENCY POKE COMMANDS for each voice 
are shown in the chart below, which also contains the NO IE VALUES for 
the middle (fifth) octave. 



VOICE NUMBER POKE 






SAMPLE MUSICAL NOTIS- 


-FtTH OCTAVE 






& FREQUENCY NUMBER 


C 


c# 


D 


D# 


E 


F 


ft 


a 


o# 


A 


A# 


B 


C 


C# 


V3ICE1/HGH 
VOICE1/LOW 


54273 
54272 


34 
75 


36 
85 


38 
126 


40 
2O0 


43 

52 


45 
196 


48 

127 


51 
97 


54 

1 1 1 


57 
172 


61 
126 


64 

188 


68 

149 


72 

169 


V0ICE2/HIGH 
VOICE2/LOW 


54280 
54279 


34 

75 


36 
85 


38 
126 


40 
200 


43 
52 


45 
198 


48 
127 


51 
97 


51 

711 


57 
172 


61 
126 


64 

188 


68 72 

U9 169 


V0ICE3/H GH 
VOICE3/1 OW 


54287 
54 9 HA 


34 
75 


36 
85 


38 

136 


40 
2O0 


43 
52 


45 
198 


48 
127 


51 
97 


54 

111 


57 
172 


61 
126 


64 

188 


68 72 
U9 169 



As yau can see, there are 2 settings for each voice, a HIGH FRE- 
QUENCY setting and a LOW FREQUENCY setting. To play a musical note, 
you must POKE a value into trie HIGH FREQUENCY location and POKE 
another value Into the LOW FREQUENCY location. Using the settings in 
our VOICE/FREQUENCYyiMOTE VALUE table, here's the setting that plays 
a C note from the 5th oc _ ave (VOICE 1); 

POKE 54273, 34: POKE 54272,75. 

The same note on VOICE2 would be; 

POKE 54280,34: POKE 54279,75. 
Used in a program, it looks like thit; 



5 FORL=54272TO54296:POKEL,0:NEXT 

10 V = 54296-W=54276 ! A=54277.* 

S = 54278 ; H =54273 ; L = 542 72 

20 POKEV,15:POKEA,1?0:POKE5,8? < 

30 POKEH,34 : POKEL,75 « 

40 POKEW,33:FORT=1TO2B0:NEXT<= 

50 POKEW,32 « 



- -£'' ■ Li[" be- 's equal Iq l?rters. 

POK.E volume. wav*lofm r attack/decoy. 

- FOKE hiflo *-s^. ■n* , *4 
—start noie r 1st it ploy 
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PLAYING A SONG ON THE COMMODORE 64 

The following program can be used to compose or play a song [using 
VOICE1). There are two important lessons in this program: First, note 
how we abbreviate all the long control numbers in the first line of the 
program , . . after that, we con use the letter W for "Waveform" instead 
of the number 54276. 

The Second lesson concerns the way we use the DATA. This program 
is set up to let you enter 3 numbers for each note: the HIGH FREQUENCY 
NOTE VALUE, the LOW FREQUENCY NOTE VALUE, and the DURATION 
THE NOTE WILL BE PLAYED. 

For this song, we used a duration "count" of 125 for an eighth note, 
250 for a quarter note, 375 for a dotted quarter note, 500 for a half 
note and 1000 for a whole rote. These number values can be increased 
or decreased to match a particular "ernpo, or your own musical taste. 

To see how a song gets entered, look at Line 100. We entered 34 
and 75 as our HIGH and LOW FREQUENCY settings to play o "C" note 
{from the sample scale shown previously) and then the number 250 for a 
quarter note. So the first rote in our song is a quarter note C. The 
second note is also a quarter note, this time the note fs "E" . . . and so 
on to the end of our tune. You can enter almost any song this way, 
adding as many DATA statement lines as you need. You can continue the 
note and duration numbers from one line to the next but each line must 
begin with the word DATA. DATA-1,-1,-1 should be the last line in your 
program. This line "ends" the song. 

Type the word NEW to erase your previous program and type in the 
following program, then type RUN to hear the song. 

MICHAEL ROW THE BOAT ASHORE-1 MEASURE 

2 FORL=54272T0542?6;POKEl,9 ; NEXT 

5 V=54296:W=54276:A=54277:HF=54273:LF=54272 ; S=54278: 

PH=54275=F>L=S4274 
10 POKEY,15:POKEA,B8:POKEPH,15:POKEPL,15:POKES,89 
20 READH:IFH = -1THENEN[> 
30 READL 
40 READD 

60 POKEHF,F:POKELF,L:POKEW,<55 
80 FORT=1TOD;NEXT;POKEW,64 
85 FORT =1TO50:N EXT 



e< 



fS GOTO 10 
100 DATA34,75, 250, 43, 52,250,51, ?7,375,43, 52,1 25,51 ,97 
105 DATA253.57, 172,250 

110 DAT A5 1,97, 500 ,0,0, 1 25, 43, 52, 250, 5 1,97, 250, 57, 172 
115 DATA1 000,5 1,97,500 
120 DATA-1,-1,-1 

CREATING SOUND EFFECTS 

Unlike music, sound effects care more often tied to c specific pro- 
gramming "action" such as the explosion made by an astro-fighter as it 
crashes through a barrier in a space game . . or the warning buzzer in 
a business program that tells the user he's about to erase his disk by 
mistake. 

You hove a wide range of options available if you want to create 
different sound effects. Here ore 10 programming ideas which might 
help you get started experimenting with sound effects; 

1. Change the volume while a note is playing, for example to create 
an "echo" effect. 

2. Vary between two notes rapidly to create a sound "tremor" 

3. Waveform ... try different settings for each voice. 

4. Attack/Decay ... to alter the rate a sound rises toward its "peak" 
volume and rate it diminishes from that peak, 

5. Sustain/Release ... to change sustain to volume of a sound effect, 
and rate ir diminishes from that volume. 

6. Multivoiee effects . . . playing more than one voice at the same 
Time, each voice independently controlled, or one voice playing 
longer or shorter than another, or serving as an "echo" or response 
lu u firs I note. 

7. Changing notes on the scale, or changing octaves, using the values 
in the MUSICAL NOTE UM.UE table. 

8. Use the Square Waveiofrn and different Pulse Settings to create 
differem effects. 

9. Use the Noise Waveform to generate "white noise" for accenting 
tonal sound effects or creating explosions, gunshots or footsteps. 

The some musical notes that create music can also be iispd with 'he 
Noi$e Waveform to creote differen - types of white noiae. 

10. Combine several HIGH/LOW frequencies in rapid succession across 
different octaves. 

11. Filter ... try the extra POKE setting in Appendix M. 
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SAMPLE SOUND EFFECTS TO TRY 

The fulluwing programs may be added to almost any BASIC program. 
They are included to give you some programming ideas and demon- 
strate the Commodore 64's sound effect range. 

Notice the programming shortcut we're using in Line 10. Wfe can 
abbreviate those long cumbersome sound selling numbers by defining 
them as easy-to-use letters (numeric variables). Line 10 simply means 
that these easy to remember LETTERS can be used instead of those long 
numbers. Here, V = Volume, W=Waveform, A= Attack/Dec cty, H = Hgh 
Frequency (VQICE1), and L=Low Frequency (VOICE 1). We trier use lliese 
letters Instead of numbers in our program . . . making our program 
shorter, typing fas _ er, and the sound settings easier to remember and 
spct. 

DOLL CRYING 

10 V = 54296:W = 54276:A = 54277: H-54273:L-54272 
20 POKEV, 15:POKEW,65:POKEA, 15 
30 FORX-200TO5STEP-2: POKE H,40:POKEL,X: NEXT 
40 FORX = 150TO5STEP-2:POKEH,40 ; POKEL,X:NEXT 
50 POKEW,0 



SHOOTING SOUND . . . USING VOICE1, NOISE WAVEFORM, FADING 
VOLUME 

10 V= 54296: W=54276:A= 54277: H =54273: L=54272 
20 FORX=15TO0STEP-J ; POKEV,X ; POKEW,.29;POKEA, 

15:POKEH,4O:POKEL,200:NEXT 
30 POKEW,0 : POKEA,0 
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CHAPTER 



ADVANCED DATA 
HANDLING 



READ 1 and DATA 
Averages 
• Subscripted Variables 

Ore-Dimensional Arrays 

Averages Revisited 
DIMENSION! 

Simulated Dice Roll With Arrays 
Two-Dimensional Arrays 



READ AND DATA 

You've ssen how to assign values to variables di-ectly within the pro- 
gram (A = 2), and how to assign different values while the program is 
running — through the INPUT statement. 

There are many times, though, when neither one sf these ways will 
quite fit the job you're trying to do, especially if it involve? a lot of 
information . 

Try this short program: 




In line 10, the computer READs one value from the DATA statement 
and assigns nat valje to X. Each time through -he loop the next value in 
the DATA statement is read and that value assigned to X, and PRINTed. 
A pointer in tne computer itself keeps track of which value is to be used 
next: 

Peinttr 
I 

40 DATA 1, 34, 10.5, 16, 234.56 



When all the values have been used, and the computer executed the 
loop again, looking for another value, the OUT OF DATA error was dis- 
played because there were no more values to READ. 
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It is important to follow the format of the DATA statement precisely: 
40 DATA 1, 34, 10.5, 16, 234.56 

t t 



each i+o-m 



Data slalemetits can contain integer numbers, real numbers (234.65), 
or numbers expressed .n scientific notation. But you can't READ other 
variables, or have arithmetic operations in DATA lines. This would be 

incorrect: 

40 DATA A, 23/56, 2*5 

You can, however, use a string variable in a READ statement and then 
place string information in the DATA line. The following is acceptable; 



13 FCJR K - 1 -to 3 

15 RERO ft* 

ee PFilHT "fl* IS HOW i "} ft* 

3© NEXT I 

40 DFlTfi THIS^ 15^ fFUN 



fl* IS 


NOW 


! TNI 9 


R* IS 


MOU 


[ is 1 


fl* IS 


HOW 


! FUN 


REftDV 







Notice that this lime, Hie READ statement was placed inside a FOR 
. . . NEXT loop. This loop was men executed to moteh the number of 
values in the dcra statement. 

In many cases you will change the number of values in the DATA 
statement each tim» the program is run. A way to avoid counting the 
number o ; values ond still ovoid an OUT OF DATA ERROR is to place a 
"FLAG" as the last value in the DATA line. This would be □ value that 
your data would never equal, such as a negative number or a very 
large cr small number. When that value is READ the program will 
branch to the next part. 

There is a way to reuse the same DATA later in the program by RE- 
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STOREing the doto pointer to the beginning of the data list. Add line 50 
to the previous program: 

50 GOTO 10 

You will still get the OUT OF DATA error because as the program 
brunches back to line 10 to reread the data, The data pointer Indicates 
all the data has been used. Now, add: 

45 RESTORE 

and RUN (he program again. The date pointer has been RESTOREd and 
the data can be READ continuously. 



AVERAGES 

The following program illustrates a practical use of READ and DATA, 
by reading in a set of numbers and calculating their average. 



: CT = @ 

20 IF K - -i THEN 50: REM CHECK FOR FLAG 

> CT = CT + 1 
30 T - T + X : REM UPDATE TOTAL 
40 GOTO 10 

50 PRINT "THERE WERE ",■ CT; '"VALUES RfcHD" 
60 PRINT "TOTAL = ";T 
70 PRINT "riVERflijE - " 
80 DATA 73 , 30, 62, 31., 87 , i> , 



RUN 

THERE WERE 7 VALUES READ 

TOTAL = 566 

AVERAGE = 80. 85? 1425 



Line 5 Sets CT, the CounTer, and T, Total, equal to zero. Line 10 READs 
a value and assigns the value to X. Line 20 checks to see if the value is 
our flag (here a —]). If The value READ is port of the valid DATA, CT is 
incremented by 1 and X is addec to the total. 

When the flag is READ, the program branches to line 50 which PRINTs 
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-he number of values read. Lire 60 PRINTs the rotcl, ard line 70 divides 
*he total by the number of values tn get the nvernge. 

By using a flag at the end of the DATA, you can place any number De- 
values in DATA statements — which may stretch over several lines — 
without worrying about counting the number of values entered. 

Anothe' variation of the READ statement involves assigning informa- 
tion from the same DATA line to different variables. This information can 
even be a mixture of string data and numeric values, You con do all this 
in the following program that will READ a name, some scores — say 
bowl nq — and print the name, scores, and the average score: 



10 REfiO H*.n.B..C 

S0 PRINT N*;'"S SCORES HERE s "?fi;' 

30 PRINT "fiND THE fiVERRGH IS: " :<f 

40 PRINT: GOTO lO 

50 DRTR HIKE., 190, 185, 165, DICK, 

68 DRTH JOHN, 155, 185, 265, PAUL, 



II II . IT i . 1 1 ■ I _ t~- 

r-ftDtcvo 

, £25, 245, 19@ 
, 169, 179, IS? 



MIKE'S SCORES WERE: 190 185. IG5 
AND THE RVERRGE IS : IBS 

DICK'S SCORES WERE: 225 j 245 l 4 ^ 
fiND THE flVERRGE IS : 2?fl 



In running the program, the DATA statements were set up in the same 
order that the READ statement expected the irformation: a name (a 
string), then three values. In other words N$ the first time through gets 
the DATA "MIKE", A in rlie READ corresponds to 1 ?0 in the data state- 
ment, "B" to 185 and "C" ts 165. The process is then repeated in that 
order for the remainder of the information. (Dick and hi& scores, John 
and his scores, and Paul and his scores.) 



SUBSCRIPTED VARIABLES 

In the past we've jsed only s'mple BASIC variables, such as A, A$, 
ond ML to represent voltes. These were a single letter -oil owed by a 
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letter or single digit. In any ot 1he programs that you would write, tf is 
doubtful that we would have a need for rrore variable names than 
possible with all the combinations of letters or numbers available. But 
you are limited in the way variables are used with programs. 

Now let's introduce the concept of subscripted variables. 

A(l) 



t_ 



Subscript 
'/orioble 



This would be said: A sub 1. A subscripted variable consists of a letter 
followed by a subscript enclosed within parentheses. Pease note the 
difference between A, Al, and A(l). Each is unique. Only A(1) is a 
subscripted variable. 

Subscripted variables, like simple variables, name a memory location 
within the computer. Think of subscripted variables as boxes to store 

information, jnsr like simple variables: 



A(0) 
A(l) 
A(2) 
AC3) 

A(4) 



It you wrote: 

10 A(0) = 25: A(3) = 55 : A(4) - -45.3 
Then memory would look like this; 



A(0) 


25 


A{1) 




A(2) 




A(3) 


55 


A(4) 


-45.3 



This group of subscripted variables is also called an array. In this 
cose, n onp-dimensiornl nrmy. Later on, we'l introduce multidimen- 
sional arrays. 

Subscripts can also be more complex to include other variables, or 
computations. The following are valid subscripted variables; 

A(X) A(X + 1J A(2-H) Ail s 3) 

The expressions within ihe parenrheses are evaluated according to the 
same rules for arithmetic operations outlined in Chapter 2. 
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Now that the ground rules are in place, how can subscrioted vari- 
ables be put to use? One way is to store a list of numbers enterec with 
INPUT or READ statements. 

Let'5 use subscripted variables to do the averages a different way. 



5 PRINT CHR*<147J 

IB INPUT "HOW MflHV NUH8ER" 

20 FOR B = 1 TO V. 

30 PRINT "ENTER VFtLUE # " .: 

40 NEWT 



ft;: INPUT B<m 



60 FOR R = 1 TO X 

re SU = 3U + B<A3 

80 NEKT 

S@ PRINT : PRINT "AVERAGE 



UQW MhiHV MUt 


■1BER 


ENTER VALUE 


# 1 


ENTER VALUE 


tt 2 


ENTER VALUE 


tt 3 


ENTER VALUE 


# 4 


ENTER VALUE 


# 5 


AVERAGE = 


161. 



There might have beer an easier way to accomplish what we did in 
•his program, but it illustrates how subscripted variables wor<. Line 10 
asks for how many numbers will be entered. This variable, X, acts as 
"he counter for the loop within which values are entered and assigned to 
•he subscripted variable, B. 

Each time through the INPUT loop, A is increased by 1 and so the next 
value entsred is assigned to the next element in the array A. For exam- 
ple, the first time through the loop A = 1, so the first value entered 
is assigned tc B(l). The next time through, A = 2; the next value is 
assigned to B(2), and so on tntil all the values huve been entered. 

5ut now a big difference comes into play. Once all the values hove 
been entered, they are stored in the array, ready to be put to work in a 
variety of ways. Before, you kept a running total each time throjgh the 
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INPUT or READ loop, but never could get back the indivdual pieces of 
dcito without re-reading the information . 

In lines 50 'hrough 80, another loop has been designed to add up the 
various elements of the array and then display the average, This sepa- 
rate part of the program shows that all o ; the values are stored and can 
be accessed as needed. 

To prove that all of the individual values ore actually stored separately 
in an array, type the following immediately af*er running the previous 
program: 

FOR A = 1 TO 5 i ?B<A),: NEXT 

125 167 189 167 

158 

The display will show your actual values as the contents of the array 
ar& PRINTed. 

DIMENSION 

If you tried to enter more than 10 numbers in the previous example, 
you got □ DIMENSION ERROR. Arrays cf up to eleven elements (sub- 
scripts to 10 for a one-dimensional array) may be used where needed, 
just as simple variables can be used anywhere within a program. Arrays 
of more than eleven elements need to be "declared" in a dimension 
statement. 

Add this lire to the program; 

5 DIM B(100) 

This lets the computer know that you will have a maximum of 100 
elements in the array. 

The dimension statement ma/ also be used with a variable, sn the 
following line could replace line 5 (don't forget to eliminate line 5): 

15 DIM B(X) 

This wou d dimension the array with the exact number of values that 
will be entered. 

Be careful, Though. Once dimensioned, an array cannot be redimen- 
sioned in another part of the program. You can, however, have multiple 
arrays with n the program and dimension then all on the same line, like 
ihis: 

10 DIM Ci2Bi), D{50), E(40> 
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SIMULATED DICE ROLL WITH ARRAYS 

As programs become mare complex, using subscripted variables will 
cut down on rhe number of statemerts needed, and make the program 
simpler fo write. 

A single subscripted variable can be used; for example, to keep track 
of (lie number of times a particular face turns up: 

1 REM DICE SIMULATION : PRINT CHR*a47> 

10 INPUT "HOW HHNY HULLS!" }X 

20 FOR L = 1 TO X 

33 R = INTCf5*RND(l>;> + l 

40 fcr:j = FCRi + l 

50 NEXT L 

60 PRINT "FflCE"^ "NUMBER OF TIMES" 

70 FOR C = 1 TO 6 : PRINT C, F(C>1 NEXT 

The array F, for FACE, will be used to keep track of how many times a 
pnrtitular face turns up. For example, every time a 2 is thrown. F(2) is 
increased by one. By using the same element of *he array to hold the 
actual number on the face that Is thrown, we've eliminated me need for 
five other variables (one for each face) and numerous statements to 
cheek and see what number is thrown. 

Line 10 asks for how many rolls you want "o simulate. 

Line 20 establishes the loop to perform the random roll and increment 
the proper element of the array by one each for each toss. 

After all of the required tosses are completed, line 60 PRINTs the 
heading and line 70 PRINTs the number of times each face shows up. 

A sample run might look like this: 



HOW MfiNV ROLLS 


s ? 1060 






FfTCE 


NUMBER 


OF 


TIMES 


1 


148 






2 


176 









17£! 






4 


166 






5 


I £3 






£ 


VfB 







Well, at least i1 wasn't loaded! 

Just as a comparison, the following is one way of re-writing the same 
program, but without using subscripted variables. Don't bother to type it 

in, bjt do notice the additional statements necessary. 
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16 INPUT "HDU MRHV ROLLS:" 

28 FOR L n 1 TO X 

30 R = INT<6*ftNDCl>>+l 

40 IF R = 1 THEN Fl = Fl + 

41 IF R = 2 THEN F2 = F2 + 

42 IF R = 3 THEN F3 = F3 + 

43 IF R = 4 THEN F4 = F4 + 

44 IF R = 5 THEN F5 = F5 + 

45 IF R = S THEN FS = FS + . 
60 PRINT "FACE"., "NUMBER OF TIMES 

70 PRIHT 1, Fi 

71 PRIHT 2, F2 

72 PRINT 3, F3 

73 PRINT 4, F4 

74 PRINT 5, F5 

75 PRINT 6, F6 



:¥. 



NEXT 
NEXT 
NEXT 
NEXT 
NEXT 
NEXT 



The program has doubled in size from 8 to 16 lines. In larger pro- 
grams the space savings from using subscripted variables will be even 
more dramatic. 

TWO-DIMENSIONAL ARRAYS 

Earlier in this chapter you experimented with one-dirnensional arrays. 
This type of nrray was visualized as a group of consecutive boxes within 
memory each holding on elenent of ihe array. What would you expect 
a twc-dirrensional array to look like? 

First, a two-dimensional array would be written like this: 

A(4,6) 
?! 

SUBSCRIPTS 
ARRAY NAME 

and could be represented as a -wo-dimensional grid within memory; 
1 2 3 4 5 6 




















1 
















2 
















3 
















4 

















The subscripts could be thought of as representing the row and col- 
umn within the table where the particular element o f the array is stored. 
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A{3,4) = 255 

T — OSLllMN 



1 

2 

3 

A 

If we assigned the value 255 to A(3,4), then 255 could be thought of 
as be'ng placed in the 4th column of the 3rd row within the table. 

Two-dimensional arrays behave according to the same rules that were 
established for une-dimensiunal urruys; 



f 


1 


2 


3 


4 


5 


6 
















































255 



















They must be dinensiored: 
Assignment of data? 
Assign valj^s 1o other variables: 
PRINT values: 



DIM A(20,20) 
A(l,l) = 255 
AB = A(l,l) 
PRINT A(l,l) 



If two-dimensional arrays work like their smaller counterparts, what 
additional cepabilit'es will the expanded arrays handle? 

Try this: can you think of a way using a two-dimensional array to 
tobulote the results of O questionnaire for your club that involved four 
questions and had up to three resporses for each question? The prob- 
lem could be represented like this: 

CLUB QUESTIONNAIRE 

Ql: ARE YOU IN FAVOR OF RESOLUTION #1? 

□ l-YES [J2-NO D3-UNDECIDED 
, . . and so on. 



roi 



The array table for this problem could be represented like this: 



YES 



RESPONSES 
NO 



UNDECIDED 



QUESTION 1 
QUESTION 2 
QUESTION 3 
QUESTION A 



The program to do the actual tabulation for the questionnaire might 
look like that shown on poge 103. 

Thts program makes use of many of trie programming techniques that 
have been p*esentecf so far, Even if you don't have any need for the 
actual program right now, see if you can follow hnw the program 
works. 

The heart of this program is a 4 by 3 two-dimensional array, A(4,3). 
The total responses for each possible answer to each question are held 
in the appropriate element of the array. For the sake of simplicity, we 
don't use the first rows and column (A(0,0) to A{0,4)). Remember, 
though, thot those elements are always present in any urruy you design. 

In practice, if question one is answered YES, then A(l,l) is in- 
cremented by one — row 1 for question 1 and column 1 for a YES re- 
sponse. The rest of the questions and answers follow the same pattern. 
A NO response for question three would add one to element A(3,2), and 
so on. 
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20 PRINT "ICLR/HOME}" 

38 FOR R = 1 TO 4 

43 PRINT "QUESTION # : " s R 

5Q PRINT " 1-YES 2-HO 3-UHDECIDED" 

60 PRINT "WHAT WAS THE RESPONSE 3 "; 

61 OET C : IF C <I or C>3 THEN 61 
"5 PRINT C: PRINT 

f FKR,C> = PKRrC? + 1: REM UPDATE ELEMENT 
S6 NEKT R 

85 PRINT 

36 PRINT "DO YOU WANT TO ENTER ANOTHER" t PRI 

"RE3F0NSE <YSH>" ; 
100 OET ft* s IF ft* ^ ■■■ THEN 160 
i 10 IF A* = "Y" THEN 28 
1 20 IF A* O "H" THEN 106 
130 PRINT "JCLR/HOHE} " J"THE TOTAL RESPONSES 

HERE:":FRINT 
140 PRINT SPCC18>;"RESP0NSE" 
111 PRINT "QUESTION 11 , "YES" , "NO", "UNDECIDED" 

142 PRINT " ' 

150 FOR R = 1 TO 4 

160 FRINT R, A<R,1>, FKR,2>, fli;R,3> 

170 NEXT R 

RUN 

QUESTION U : 1 

1-YES 2-HO 3-UNDECIDED 

WHAT WAS THE RESPONSE : 1 

QUESTION tt : 2 

1-YES 2-NO 3-UNDECIDED 

WHAT HFlS THE RESPONSE : 1 



Find so on. . , 



THE TOTAL RESPONSES MERE; 



RESPONSE 
HO 
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INTRODUCTION 

Now that you've become more intimately involved with your Commo- 
dore 64., we want you to know that our customer support does not stop 
hero. You may not know it, but Commodore has b^en in business Fur 
over 23 years. In the 1970's we introduced the first self-contained per- 
sonal computer (the PET). We nave since become the leading computer 
company in many countries of the world. Our ability to design and 
manufacture our own computer chips allows us to bring you new und 
better personal computers at prices way below what you'd expect for 
this level of technical excellence. 

Commodore is committed to supporting not only you, the end user, 
but also the d«a<er you bought your computer from, magazines which 
publish how-to articles showing you new applications or techniques, 
and . . . importantfy . . . software developers who produce programs 
an cartridge, disk, and tape for use with your computer. We eneoiimge 
you to establish or join a Commodore "user club" where you can learn 
new techniques, exchange ideas and share discoveries. We publish two 
separate magazines which contain programming tips, information on 
new products and ideas lor computer applications. (See Appendix N). 

In Worth America, Commodore provides a "Commodore Information 
Network" on trie CompuServe Information Service . . . lu uccess this 
network, all you need is your Commodore 64 computer and our low cost 
VICMODEM telephone interface cartridge (or other compatible modem). 

The following APPENDICFS contnin charts, tables, and other informa- 
tion which help you program your Commodore 64 faster and more 
efficiently. They also include important information on the wide variety 
oF Commodcre products you may be interested in, and a bibliography 
listing of Oi/er 20 books and" magazines which can help you develop your 
programming skills and keep you current on the latest information con- 
cerning your computer and peripherals. 
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APPENDIX A 



COMMODORE 64 ACCESSORIES 
AND SOFTWARE 



ACCESSORIES 

The Commodore 64 will support Commodore VIC 20 storage devices 
and accessories — DArASSE TIE recorder, disk drive, modem, printer — 
so your system can expand to keep pace with changing needs. 

• Datasette Recorder — -This low, cost tope unit enables programs and 
dota to be 3tored on cassette tape, and played bock at u later 
rime. The datasette can also be used to play pre-writren programs. 

• Disk — The single disk unit uses standard 5Vi-inch floppy diskettes, 

about - he size of a 45 RPM 'ecnrd, to 5tnrp» prngmms nnd data. 
Disks allow faster access to data and hold up to 170,000 char- 
acters of information each. Disk units are "Intelligent," meaning 
they hove their own microprocessor and memory. Disks require no 
'esourees from the Commodore 64, such as using part of main 
msmory. 

• Modem — A low-cost communication device, the VICMODEM allows 
access to other computers over srdinary telephone lines. Users will 
have access to the full resources of large data bases such as The 
Source, CompuServe, and Dow Jones News Retrieval Service (North 
America only), 

• Printer — The VIC printer produces printed copies of programs, 
data, or graphics. This 30 character per second dot-matrix prfnter 
uses plain tractor feed paper and other inexpensive supplies. The 
printer attaches directly to the Commodore 64 without any addi- 
tional Interfaces. 

• Interface Cartridges — A number of specialized cartridges will be 
available for the Commodore 64 to allow various standard devices 
such as modems, printers, controllers, end Instruments to be at- 
tached to the system. 
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With a special IEEE-488 Cartridge, the Commodore 64 will support 
the full range of CBM peripherals including disk units and printers. 

Additionally, a Z80 cartridge will allow you to run CP/M* on the 
Commodore 64, giving you access to the largest base of 
microcomputer applications available. 



SOFTWARE 

Several categories of software will be offered for the Commodore 64, 
providing you with a wide variety of personal, entertainment, and edu- 
cational applications to choose from. 

BUSINESS AIDS 

• An Electronic Spreadsheet package will allow you to plan budgets, 
and perform "what if?" analysis. And with the optional graphic 
program, meaningful graphs may be created from the spreadsheet 
data. 

• Financial planning, such as loon amortization, will be easily han- 
dled with the Financial Planning Packcge. 

• A number of Professional Time Management programs will help 
manage appointments and wor load. 

• iasy-to-use Data flase programs will allow you to keep track of 
information . . . mailing lists . . . phone lists . . . inventories . . . 
and organize information in a useful form. 

• Professional Ward Processing programs will turn the Commodore 64 
into □ fuil-featured wore processor. Typing and revising memos, 
letters, and other text material become a breeze. 

ENTERTAINMENT 

• The highest quality games will be available on plug-in cartridges 
*or the Commodore 64, providing hours of enjoyment. These pro- 
grams make use of the high resolution graphics ond full sound 
range possible with the Commodore 64, 

• Your Commodore 64 allows you all the fun and excitement avail- 
able on MAX games because these "two machines have completely 

compatible cartridges. 



*CP/M a a 'egistered trademark of Digital Research Inc. 
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EDUCATION 



The Commodore 64 is a tutor that never tires arid always gives 
personal attention. Besides Access ro much of the vast PET educa- 
tional programs, additioral educational languages that will be 
available for the Commodore 64 Include PILOT, LOGO ond other 
key advanced packages. 
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APPENDIX B 



ADVANCED CASSETTE OPERATION 



Besides saving copies of your programs on tope, the Co-nmodore 64 
can also stores the values of variables and other items of data, in a 
group called a FILE. This allows yuu to store even more informal ion thun 
could be held in the computer's main memory at one time. 

Statements used with data files are OPEN, CLOSE, PRINT*, INPUT#, 
and GET#. The system variable ST (status) is used to check for tape 
markers. 

In writing data to tape, the same concepts are used as when display- 
ing information on the computer's screen. But instead of PRINTing in- 
formation on the screen, the information is PRINTed on tape using a 
variation of the PRINT command — PRINT#. 

The following program illustrates how this works: 



10 PRINT "URITE-TO-TRPE-PROGRRM" 

20 OPEN 1,1,1, "DATA FILE" 

30 PRINT "TVPE DATA TO BE STORED OR TVPE STOP" 

50 PRINT 

S0 INPUT "DATA"? A* 

?e print #i, a* 

3@ IF P* O"ST0P" THEN 50 
98 PRINT 

100 PRINT "CLOSING FILE" 
110 CLOSE 1 



The first thing that you must do is OPEN a file (in this case DATA FILE). 
Line 10 handles that. 

The program promp-s for the data you want to save on tope in line 

60. Line 70 writes what you typed — held in A?- — onto the tcpe. And the 
process continues. 

If you type STOP, lire 110 CLOSES the file. 
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To retrieve the information, rewind the tope, and try tri i: 



10 PRINT "RERD-TRPE-PROORRM' 

20 OPEN i,t,0.,"DflTf) FILE" 

30 PRINT "FILE OPEM" 

40 PRINT 

50 INPUT#1, H* 

GO PRINT R* 

70 IF n* - "STOP" THEN END 

30 GOTO 40 



Again, ths file "DATA FILE" first must bt: OPENed. In line 50 the pru- 
grarr INPUTS A$ from tape and also PRIMTs A$ on the screen. Then the 
whole process is repeated until "STOP" is found, which ENDs the pi-o- 
greirr. 

A variation of GET CET# can 0I30 be used to read the data back 

from tape. Replace lines 50-80 in the orogram above with: 



5© GET#1, fl* 
60 IF H* = "" THEN END 
70 PRINT H*., flGC<rr*> 
80 GOTO SO 
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APPENDIX C 



COMMODORE 64 BASIC 



This manual has given you an introduction to the BASIC language — 
enough for you to get a feel for computer programming and some of 
the vocabulary involved. This appendix gives a complete list of the rules 
(SYNTAX) of Commodore 64 BASIC, alyny with concise description;. 
Please experiment with these commands. Remember, you can't do any 
permanent damage to -he computer by just typing in programs, and the 
best way to learn computing is by doing. 

This ap&endix is divided into sections according to the different types 
of operations in BASIC, These include: 

1. Variables and Operators: describes the different type of variables, 
legal variable names, and arithmetic and logical operators. 

1. Commands: describes the commands used to work with programs, 
edit, store, and erase them. 

3. Statements: describes the BASIC program statements used in num- 
bered lines of programs, 

4. Functions: describes the string, numeric, and print functions. 



VARIABLES 

The Commodore 64 uses three types of variables in BASIC. These ore 
real numeric, integer numeric, end string (alphanumeric) variables. 

Variable names may consist of a single letter, o letter followed by a 
number, or two letters, 

An integer variable is specified by using the percent (%) sign after the 
variable name. String variables have the dollar sign [$) ofter their 
name. 

EXAMPLES 

Real Variable Names: A, A5, BZ 

Integer Variable Names: A%, A5%, BZ% 
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String Variable Names: A$, A5$, BZS 

Arrays ore lists of variables with the same name, using extra numbers 
to specify the element of the array. Arrays are defined using the DIM 
statement, and may contain floating point, integer, or string variables, 
the array variable name is followed by a set of parentheses ( ) enclos- 
ing the number of variables in the list. 

A(7>, B2%(11), A$(5v), PT{20,20) 

NOTE: There are three variable names which are reserved for use by 
the Commodore 64, and may not be defined by you. These variab es 
are; ST, Tl, and Tl$. ST is a status variable which relates to input/output 
operations. The value of ST will change if there is a problem loading a 
program f rom disk or tope. 

Tl and Tl$ are variables which relate to the real-time clock built into 
the Commodore 64, The variable Tl is updated every Vdoth of a second, 
lr srarts at when the computer is turned on, and is reset only by chang- 
ing the value of Tl$. 

Tl$ is a string which is corstantly updated by the system. The first two 
characters contain the number of hours, the 3rd and 4th characters the 
number of minutes, and the 5th and 6th characters are the number of 
seconds. This variable can be given any numeric valje, and will be 
updated from that point. 

Tl$ - "101530" sets the clock to 10:15 and 30 seconds AAA. 

This clock is erased when the computer s turned off, and starts at 
zero when the system is turned back on. 

OPERATORS 

The arithmetic operators include the following signs; 

4- Addition 

— Subtraction 

* Multiplication 

/ Division 

"f Raising to a power (exponentiation) 

On a line containirg mare than one aperator, there is a set order in 
whirh operations always occur. If several operations are used together 
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on the seme line, the computer ossigns priorities as follows: First, ex- 
ponentiation. Next, rnultiolication ard division, and lest, addition and 
subtraction. 

You can change the orde- of operalions by enclosing witnin pa- 
rentheses the cclculation to be oerformed first. Operations enclosed in 
parentheses will take place before other operations. 

There are also operations for equalities and inequalities: 

= Equal To 

< Less Than 

> Greater Than 

<= Less Than or Equal To 

>= Greater Than or Equal To 

<> Not Equal To 

Finally, there are three logical operators; 

AND 
OR 
MOT 

These are used most often lo join rnulliple formulas in IF . . . THEN 
statements. For example; 

IF A = B AND C = D THEN 100 (Requires both parts to be true) 

IF A = B OR C = D THEN 100 (Allows either part tD be true) 



COMMANDS 

CONT (Continue J 

This command is used to restart the execution of a prog r am which has 
been stopped by either using the STOP key, a STOP statement, or an 
END statement within the program. The program will restort at the sxact 
place from where it left off. 

CONT will not work if you have changec or added lines to the pro- 
gram (or even just moved The cursor), or if the program hahed due to an 
error, or if you caused an error before trying to restart the program. In 
these cases you will get a CAN'T CONTINUE ERROR. 
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LIST 

The LIST command allows you to look at lines nf a BASiC program in 
memory. You can ask for the entire program to be displayed, or only 
certain line numbers. 

LIST Shows eitire program 

LIST 10— Shows only from line 10 until end 

LIST 10 Shows only line 10 

LIST —10 Shows line; 'from beginning until 10 

LIST 10-20 Shows line from 10 to 20, inclusive 

LOAD 

This command is used "O transfer a program from tape or disk irile 
memory so the program can be used. If you just type LOAD and hit 
RETURN, the first program found on the cassette unit will be placed in 
memory. The command may bs followed by a program name enclosed 
within quoles. The name may then be folbv/-ed by a comma and o 
number or numeric variable, which acts as a device number to indicate 
where the program is coming from. 

If no device number is given, the Commodore 64 assumes device #1, 
which is the cassette unit. The other device commonly jsed with the 
LOAD command is the disk drive, which is device -#8. 

LOAD Reads in tie next program on tcpe 

LOAD "HELLO" Searches tape f°' program called 

HELLO, and louds program, if found 
LOAD A$ Looks for program whose name is in the variable A$ 

LOAD "HELLO",8 Looks for program called HELLO on tne disk drive 
LOAD "*",8 Looks for first program on disk 

NEW 

This comrrand erases the entire Drogram In merno r y, and also clears 
out any variables that may have been used. Unless the program was 
SAVEo, it is bst. BE CAREFUL WHEN YOU USE THIS COMMAND. 

The NEW command can also be used as a BASIC program statement, 
When the program reaches this I ne, the program is erased. This is use- 
ful if you want to leave everything neat when the program is done. 
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RUN 

This command causes execution of a program, once the orogram is 
loaded into memory. If there Is no line number following RUN, the com- 
puter will start with ihe lowest line number. If a line number is desig- 
nated, the program will starl executing from the specified line. 

RUN Starts program at lowest line number 

"UN 100 Starts execuTion at line 100 

RUN X UNDEFINED STATEMENT ERROR. You must 

always specif/ an actual line number, 

not a variable representation 



SAVE 

This command will srore the program currently in memory on cassette 
or disk. If you just type SAVE and RETURN, the program will be SAVEd on 
cassette. The computer has no way of knowing if there is o program 
already on that tope, so be careful with your tapes or you may erase a 
valuable program. 

If you type SAVE followed by a name in quotes or a string varable, 
the computer will give the program that name, to it can be mare easily 
located and retrieved in the future The name may also be followed by 
a device number. 

After the device number, there can be a comma and a second 
number, either or 1 . \- the second number is 1 , the Commodore 64 will 
put on EMD-OF-TAPE marker after your program. This signals the 
computer not to look any further on the tape if you were to give an 
tiddilionul LOAD command. If ycu try to LOAD a program and the com- 
puter finds one of these markers, you will get a FILE MOT FOUND ER- 
ROR. 

SAVE Stores program to tape without name 

SAVE "HtLLO" Stores on tape with name HELLO 

SAVE AS Stores on tape with name in AS 

SAVE "HELLO", 8 Stores on disk with name HELLO 

SAVE "HELLO",!,! Stores on -ape with name HELLC 

and follows program w'th END-OF- 
TAP; marker 
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VERIFY 

Thk command causes the computer to check the program on diik or 
tape against the one in nreinory. Thii is proof that the program is actu- 
ally S/WEd, in case the tape or disk is bad, or something went wrong 
during the SAVE. VERIFY without anything after the commend causes the 
Comrncdore 64 to check the next p'ograrn on tape, regardless of name, 

against the program in memory. 

VERIFY followed by a program name, or a string variable, will search 
for that program and then check. Device numbe r s can also be included 
with the verify command. 

VERIFY Checks the next program on tape 

VERIFY "HELLO" Secrches for HELLO, checks against memory 

VERIFY "HELLO", 8 Secrches for HELLO on disk, then checks 



STATEMENTS 

CLOSE 

This commanc completes and closes any files used by OPEN state- 
ments. The number following CLOSE is the file number to be closed. 

CLOSE 2 Only file #2 la closed 



cut 

This command will erase any variables in memory, but leaves the 
program itself intact. This command is qutcmatically execu*ed when a 
RUN command is given. 

CMD 

CMD sends the output which normally wouid go to the screen (i.e., 
PRINT statements, LISTs, but not POKEs onto the screen) to another de- 
vice instead. This could be o printer, or a datu file on tape or disk. This 
device or file must be OPENed first. The CMD command must be fol- 
lowed by a number or numeric variable referring to the file. 
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OPEN 1 ,4 OPENs device #4, which is the printer 

CMD 1 All normal output now goes to printer 

LIST The program listing now goes to 

the printer, not the screen 

To send output back to the screen, CLOSE the file with CLOSE 1 . 
DATA 

This statement is followed by a list of items to be used by READ 
statements. Items may be numeric values or text strings, and items are 
separated by commas. String terns need not be inside quote morks 
unless mey contain space, colon, or comma. If two commas have noth- 
ing between tnem, the value will be READ as a zero for a number, or an 
empty string. 

DATA 12, 14.5, "HELLO, MOM".. 3.14, PARTI 

QEF FN 

Th's co-nmond allows you to define a complex calculation as a func- 
tion with a short name. In the case of a long formula that is used many 
-imes within the program, this can save time and space. 

The -unction name will be FN and any legal variable name (1 or 2 
characters long). First you must define the function using the statement 
DEF fol owed by the fuic"ion name. Following the name is a set of pa- 
rentheses enclosing ci numeric variable. Then -gllows the actual formula 
'hat you want to define, with the variable in the proper spot. You can 
then "call" the formula, substituting any number for the variable. 

10DEF FNA(X) = 12*(34.75 X/.3) 



20 PRINT FNA(7t T 

J 7 is irr 



I I ' is instrtfrd swher* 

X is in 1ne r o-rYulQ 



Foi this example, ihe resjll would be 137. 



DIM 

When yot use more than 1 1 elements of an array, you must execute u 
DIM statement for -he array. Keep in mind that the whole array takes up 
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room in memory, so don't create an array much larger than you'll need. 
To figure the number of variables created with DfM, multiply the total 
number of elements in each dimension of the crrgy. 

10 DIM A$(40), B7(15), CC%{4,4,4) 

It t 

41 ElEMENTS li ELEMENTS 125 ELEMENTS 

You can dlmensior more than "one array ' n a DIM statement. How- 
ever, be careful not to dimension an array more than once. 

END 

When a program encounters an END statement, the program halts, as 
if it ran out of lines. You may use COWT to restart the program. 

FOR. . TO. . STEP 

This statement works with the NEXT statement to repeat a sect'on of 
the program a set lumber of times. The format is: 

FOR (Var. Name)-(Start of Count) TO (End of Count) STEP(Count By) 

The loop variable will be added to or subtracted from during the 
program. Without any STEP specified, STEP is assumed to be 1. The start 
count and end count are the limits to the value of the loop variable. 

10 FOR L = 1 TO 10 STEP .1 
20 PRINT L 
30 NEXT L 

The end of the loop value may be followed by the word STEP and 
another number or variable. In this case, the value following STEP is 
added each time instead o^ 1. This allows you to count bockwords, or 
by fractions. 

GET 

The GET statement alicws you to get data from the keyboard, one 
chorocter at a time. When GET is executed, the character that is typed is 
assigned to the variable. If no character is typed, then a null (empty) 
character is assigned. 
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GET is folluwtd by o vuriuble num^, usually o string variable. If a 

numeric variable was used and a nomumeric key depressed, the pro- 
gram would halt with an error rmesscge. The GET statement may be 
pieced into a loop, checking for any empty result. This loop will continue 
until □ key is iiil. 

10 GET A$ ; IF A$ ="" THEN 10 

GET# 

The_GET# statement is used with o previously OPENed device or file, 
to input one character at a time from that device or file. 

GET #1,A$ 

this would input one character from a data file. 

GOSUB 

This stuienenl is similar to GOTO, except the computer remembers 
which program line it last executed before the GOSUB. When a line with 
o RETURN statement is encountered, the program Jumps back to the 
statement immediately following the GOSUB. This is useful if there is a 
routine in ygur pioyrurn ihut occurs in several parts of the program. 
Instead of typing the routine over and over, execute GOSUBs each time 
the rouline is needed. 

20 GOSUB 800 

GOTO OR GO TO 

When a statement with the GOTO command is reached, the next line 
to be executed will be *he one with the line number following the word 
GOTO. 

IF. . .THEN 

IF. . THEN lets the computer analyze ci situation and take two possi- 
ble cou'ses of action, depending on the outcome. If the expression is 

true, the statement following THEN is executed. This may be any BASIC 
statement, 

It the expression is fclse, the program goes directly to the next line. 

The expression being evaluated may be a variable or formula, in 
which case it is considered true if nonzero, end false if zerc. In most 
cases, there is an expression involving relational operators (=, <, >, 
<=, >=, <>, AND, OR, MOT), 
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10 IF X > 10 THEN END 

IMPUT 

The INPUT statement allows the program to get data from the user, 
cssigning that data to a variable. The program will stop, print a ques- 
tion mark (?) on the screen, and wail for the user to type in the answer 
end hit RETURN. 

INPUT is followed by a variable name, or a list of variable names, 
separated by commas. A message may be placed within quote marks, 
before the list of variable names to be INPUT. If more than one variable 
Is to be INPUT, they must be separated by commas when typed. 

10 INPUT "PLEASE ENTER YOUR FIRST NAME ";A$ 
20 PRINT "ENTER YOUR CODE NUMBEP"; r INPUT B 

INPUT* 

IMPUT# is simila* to INPUT, but takes data from a previously OPENed 

file or device. 
10 INPUT#1, A 

LET 

LET is hardly ever used in programs, since It Is optional, but 'he 

statement Is the heart of all BA5IC progrcms. The i/ariable name which 
is to be ass gned the result of a calculation is on the left side of the 
equal sign, and the formulc on the right. 

1 LET A - 5 

20 LET D$ = "HELLO" 

NEXT 

NEXT is always used n conjunction with the FOR statement. When the 
program reaches a NEXT statement, it checks the FOR statement to see 
if the limit of the loop has been reached. If the loop is not finished, "he 
loop variable is increased by the specified STEP volue. If the loop is 
finished, execution proceeds with the statement following NEXT. 
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NEXT may be followed by a variable name, or list of variable names, 
separated by commas. If there are no names listed, me last loop started 
(S the one being completed. If variabfes tire given, they are completed 
in order from left to right. 

10 FOR X = I TO 100: NEXT 
ON 

This command turns the GOTO and GOSUB commands into special 
versions of the IF statement. ON is followed by a formula, which s 
evaluated. If the result of the calculation is one, the first line on the list is 
executed; if the 'esulr is 2, the second line is executed, and so on. If the 
result is 0, negative, or larger than the list of numbers, the next line 
executed wilf be the statement following the ONI statement. 

10 INPUT X 

20 ON X GOTO 10,20,30,40,50 

OPEN 

The OPEN statement allows the Commodore 64 to access devices such 
as the cassette recorder and disk for data, a printer, or even tne screen. 
OPEN is followed by a number (0-255), to which all following statements 
will refer. There is usually a second number after the first, which is The 
device number. 

The device numbers are: 

Screen 

1 Cassette 
4 Printer 

8 Disk 

Fullowiny the device number may be a Third number, separa-ed 
again by a comma, which h the secondary address. In the case of the 
cassefte, this is for read, 1 for write, and 2 for write with enH-of-tope 
marker. 

In Ihe case of the disk, the number refers to the buffer, or channel, 
number. In the printer, the secondary address controls features like ex- 
panded printing. Seethe Commodore 64 Programmer's Reference Man- 
ual for more details. 
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10 OPEN 1,0 OPENS the SCREEN as a device 

20 OPEN 2,1,0, J 'D" OPENs the cassette for reading, 

file to be searched for is D 
30 OPEN 3,4 OPENs the printer 

40 OPEN 4,8,15 OPENs the data channel on the disk 

Aisc see; CLOSE, CMD, GET#, INPUT#, ard PRINT* , system variable 

ST, and Appendix B. 

POKE 

POKE is alwcys followec by two numbers, or formulas. The firtt loca- 
tion is a memory location; the second number is u uecirnul value frum 
to 255, which will be placed in the memory location, replacing any pre- 
viously stored value, 

10 POKE 53231,0 

20 S=4096*13 
30 POKE S+29,8 

PRINT 

The PRINT statement is the first one most peopfe learn to use, but 
there are a number of variations to be aware of. PRINT can be followed 
by: 

Text String with quotes 
Variable names 
Functions 
Punctuation marks 

Punctuation marks are used to help format the data on the screen. 
The comma divides the screen into four columns, while the semicolon 
suppresses all spacing. Either mark can be the last symbol on a line. 
This results in the nexl thing PRINTed acting as if it were a continuation 

of the same PRINT statement. 

10 PRINT "HELLO" 
20 PRINT "HELLO",A$ 
30 PRINT A+B 
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A% PRINT J; 

60 PRINT A,B,C,D 

Also see: POS, SPC and TAB functions 

PRINT* 

There are a few differences between this statement and PRINT. 
PRINT?? [3 followed by a number, which -efers tu ihe device or data file 
previously OPENed. This number is followed by a comma and a list to be 
printed. The comma and semicolon have the some effect as they do n 
PRINT. Please note that some devices may not work with TAB and SPC. 

108 PRINTS 1 /'DATA VALUES"; A%, Bl, C4 

READ 

READ is used to assign information from DATA statements to vari- 
ables, so the information rnoy be put \o use. Care must be raketi to 
avoid READing strings where READ is expecting □ number, which will 
give a TYPE MISMATCH ERROR. 

REM (Remark) 

REMark is a note to whomever is reading a LIST of tne program. It 
may explain a section of the program, or give additional instructions. 
REM statements in no way affect the operation of the program, except 
to add to its length. REM may be followed by any text. 

RESTORE 

When executed in a program, the pointer to which an item in a DATA 
statement will be READ next is reset to the first item in the list. This gives 
you the ability to re-READ the nfomation. RESTORE stands by itself on a 
line. 

RETURN 

This statc-ncnl Is olways used in conjunction with COSUB. When the 
program encounters a RETLRN, it will go to the statement immedia-ely 
following the GOSUB command. H no GOSUB was previously issued, a 
RETURN WITHOUT GOSUB ERROR will nmir. 
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STOP 

This statement will halt program execution. The messcge, BREAK IN 
xxx. will be displayed, where mk is the line number containing STOP. The 
program may be restarted oy using the CONT command. STOP is nor- 
mally used in debuggirg a program. 

SYS 

SYS is followed by a decimal number or numeric value in the range 
0-65535. ""he prngrarn will then begin executing the machine language 
program storting at that memory loection. This is similar tc the USR 
function, but does not allow parameter passing. 

WAIT 

WAIT is used to halt the program until the contents of a memory loca- 
tion change; in a specific way. WAIT is followed by a memory location 
(X) and up to two variables. The format is: 

WAIT X,Y,Z 

The contents of tie memory location are first exclusive-ORed with the 
third number, if present, an<i then logically ANDed with the second 
number. If the result is zero, the program goes back to that memory 
location and checks again. When the result is nonzero, The program 
continues with the next statement. 



NUMERIC FUNCTIONS 

ABS(X) (absolute value) 

AB5 returns the absolute value of rhe number, without its sign i+ or 
— ). The answer is always positive, 

ATN(X) (arctangent) 

Returns the angle, measured in radians, whose tangent is X. 
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COS(X) (cosine} 

Returns the value of the cosine of X, where X is an angle measured in 
radians. 

EXP(X) 

Returns the volua of the mothemaricaf constant e(2.7T 327183) raised 
to the power of X, 

FNxx(X) 

Re-urns the value of the user-defined function xx created tn a DEF 
FNxx(X) statement, 

INT(X) 

Returns the truncated value of X f that is, with oil the decimal places 
to the right of the decimal point removed. The result will alwoys be less 
than, or equal to, X, Thus, any negative numbers with decimal places 
will become the integer less than their current value. 

LOC(X) (logarithm) 

Will return the natural log of X, The natural log to the base e (see 
EXP(X)), To convert to log base 10, simply divide by LOG(IO). 

PEEK(X) 

Used to find out contents of memory location X, in the range 0-65535.. 
giving a result from 0-255. PEEK is often used in conjunction with the 
POKE statement. 

RND{X) (random number) 

RND(X) returns a random number in the range 0-1. The first random 
number should be generated by -he formula RND{— Tl) to stcrt things off 
differently every time. After this, X should bo a 1 or any positive 
number. If X Is zero, the result will be the same random number as the 
last one. 
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A negative value for X will reseed the generator. The use of the same 
negative number for X will result in the same sequence of "randcm" 
numbers. 

The formula for generating a number between X and Y is: 

N = RND(1)*(Y-X)+X 

where, 

V is the upper lim't 

X is the lower range of numbers desired. 

SGN[X) (sign) 

This function returns the sign (positive, negative, or zero) of X. The 
result will be + 1 if positive, if zero, and —1 if negative, 

SIN(X) (sine) 

SIM(X) is the trigonometric sine function. The result will be the sine of 

X, where X is an angle in radians. 

SQR(X) (square root) 

This function will return the square root of X, where X is a positive 
number or 0. If X is negative, an ILLEGAL QUANTITY ERROR results- 

TAN(X) (tangent) 

The result will be the tongent of X, whsre X if an angle in radians. 

USR(X) 

When this function is used, the program jumps to a machine Icngucge 
program whose starting point is contained in memory locations. The pa- 
rameter X is passed to the machine language program, which will re- 
turn another value beck to the BASIC program. Refer to the Commodore 
64 Programmer's Reference Manuel for more details on this function 
and machine language programming. 
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STRING FUNCTIONS 

ASC{X$) 

This function will return the ASCII code of the firs* character of X$, 

CHR$(X) 

This is the opposite of ASC, and returns a string character whose 
ASCII code is X. 

LEFT${X$,X) 

Returns a string containing the leftmost X characters of $X. 
LEN(X$> 

Returned will be the number of characters (inducing spaces and 
other symbols) ir the string X$. 

MID$(X$,S,X) 

This wil return a string containing X characters starting from the Sth 
choractei in X$. 

RIGHT$(X$,X) 

Returns the rightmost X character* in X$. 
STR$(X) 

This will return a string which is identical to the PRIMTed version of X. 

VftL(X$) 

This function converts X$ into o number, and is essentially the inverse 
operation from STR$. The string h examined from the leftmost character 
to the right, for os many characters as are in recognizoble number for- 
mat. 
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10 X = VALC" 123.456") X = 173.456 

10 X ~ VALC12A13B") X = 12 

10 X = VALCRIU017") X = 

10 X = VAL ("- 1.23.45.67") X = -1.23 



OTHER FUNCTIONS 

FRE(X) 

This function re _ urns the number of unused bytes available in memory, 
regardless of the valus of X. No-e that FRE{X) will read out n negative 
nurrbers if the number of unused bytes is over 32K. 

POS{X) 

This function returns the rumber of the column (0-39) at which trie 
next PRINT siatemenr will begin on the screen. X may have any valje 
and is not used. 

SPC(X) 

This is used in □ PRINT statement to skip X spaces forward. 

TAB(X) 

TAB is also used in a P3INT statement; the next 'tern to be PRINTed will 
be in column X. 
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APPENDIX D 



ABBREVIATIONS FOR 
BASIC KEYWORDS 



As a lime-saver when typing in programs and commands, Commo- 
dore 64 BASIC allows the user to abbreviate most keywords- The ab- 
breviation for PRINT is a question mark, The abbreviations for other 
words are mode by typing the tirs-t one or two letters of the word, fol- 
lowed by the SHI Red next letter of the word. If the abbreviations are 
used in a program line, the keyword will LIST in the full form. 



Com- 
mand 


Abbrevi- 
ation 


Look* lilt* 
tkic on 
scroan 


Com- 
mand 


Abbrevi- 
ation 


Looks like 
this on 
screen 


ABS 


A t-i'lal B 


a CD 


END 


E Mlllt N 


E 14 


AND 


A £j|m N 


A0 


EXP 


E QB x 


E ® 


ASC 


A IjjjQjJ S 


A® 


FN 


NONE 


FN 


ATN 


A EDI r 


a O 


FOR 


r QQ O 


^ n 


CHR$ 


C fflTTt H 


cED 


FRE 


F fj 2 R 


F B 


CLOSE 


CL B 1 ° 


cC 


GET 


G (v'. : ] E 


o B 


CLR 


C l/-'- 1 ^ L 


C C 


GET# 


NONE 


GET# 


CMD 


C t-i:ii3* M 


^s 


GOSUB 


goQQ.s 


Go H 


CONT 


c IhillJ o 


cD 


GOTO 


G BJ o 


g n 


COS 


NONE 


cos 


IF 


NONE 


IF 


DATA 


D £jj|hj| A 


D® 


INPUT 


NONE 


INPUT 


DEF 


D EEi e 


°Q 


INPUT# 


1 |jjjj[j| N 


1 


Dim 


D | ffl ]j I 


^ 


INT 


NONE 


INT 
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Looks like 






Looks like 


Com- 


Abbrevi- 


this on 


Com- 


Abbrevi- 


this on 


mand 


ation 


screen 


mand 


ation 


screen 


LEFTS 


_E E 3 r 


*B 


RIGHTS 


R Eflgl 1 


*H 


LEN 


NONE 


.EN 


RND 


r E!tT3 n 


Ri/ 


LET 


_ Ulllil E 


^n 


RUN 


R P!tT?| u 


*;^: 


LIST 


L Oi| 1 


^a 


SAVE 


S KUbl A 


s[*] 


LOAD 


I I'iJ'l O 


l n 


SGN 


s E!tt3| g 


sD 


LOG 


NONE 


LOG 


SIN 


s EfflJI i 


S0 


MID$ 


Vl^^J 1 


»Q 


SPC< 


s [;Q p 


s n 


NEW 


NONE 


NEW 


SQR 


s| Q Q 


*■ 


NEXT 


N Kfflffl E 


n g 


STATUS 


ST 


ST 


NOT 


n E251 ° 


N g 


STEP 


STUIIIafl E 


stQ 


ON 


NONE 


ON 


STOP 


5 U^JjI [ 


SO 


OPEN 


•-' EI lil p 


o3 


STR$ 


ST ^^3 R 


ST g 


OR 


NONE 


OR 


5Y$ 


s ^^3 Y 


sQ 


PEEK 


P UJ||| E 


>B 


EAB( 


t E!1Tj1 a 


r® 


POKE 


P ^0| O 


>n 


TAN 


NONE 


TAN 


POS 


NONE 


POS 


THEN 


T EB M 


tQ 


PRINT 


? 


? 


TIME 


Tf 


T! 


PRINT* 


p jum r 


p p 


TIMES 


Tl| 


Tl$ 


READ 


r edsi e 


R H 


JSR 


u El s 


u@ 


REM 


NONE 


fiEM 


VAL 


v umj a 


v® 


RESTORE 


re mi s 


RE® 


VERIFY 


v EEl E 


vH 


RETURN 


RE Ulllal T 


*L=JJ 


WAIT 


wCilHl a 


wffl 
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APPENDIX E 



SCREEN DISPLAY CODES 



The following chart lists all of the characters built into the Commodore 
64 character sets. It shows which numbers should be POKEd ir to screen 
memory ;!ocatons 1024-2023) to gel a desired character. Also shown is. 
which character corresponds to a number PEEKed from the screer. 

Two character spts are available, but only one set at a time. This 
means that you cannot have characters from one set on the screen at 
the same time you have characters from the other set displayed. The 
sets are switched by holding down the £3251 an d GJ keys s'mul- 
toneously. 

From BASIC, POKE 53272,21 will switch to upper case mode and 
POKE 53272,23 switches to lower case. 

Any number on the chart may also be displayed h REVERSE. The 
reverse character code may be obtained by adding 128 to the values 
shown . 

If you want to display a sold circle at location 1504, POKE the code 
for the circle (81) into location 1604: POKE 1504,81. 

There is a corresponcing memory location to control the color of each 
rhararter displayed on the screen (locations 55296-56295). To change 
the color of -he circle to yellow (color code 7) you would POKE the corre- 
sponding memory location (55776) with the character color: POKE 
55776,7. 

Refer to Appendix G for the complete screen and color memory 
maps, along with color codes. 



SCREEN CODES 



SET1 


SET 2 


POKE 


SET1 


SET 2 


POKE 


SET1 


SET 2 


POKE 


@ 







c 


g 


3 


F 


f 


6 


A 


a 


1 


D 


d 


4 


G 


g 


7 


6 


b 


2 


E 


e 


5 


H 


i 
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SET 1 SET 2 


POKE 


SET 1 SET 2 POKE 


SET 1 


SET 2 


POKE 


I 


I 


9 


% 


37 


a 


A 


65 


J 


J 


10 


& 


36 


ffl 


B 


56 


K 


k 


11 


1 


39 


3 


C 


67 


L 


! 


12 


f 


40 


H 


D 


56 


M r 


n 


13 


) 


41 


3 


E 


6S 


N 


n 


14 


* 


42 


□ 


F 


70 








15 


+ 


43 


D 


G 


71 


P 


P 


16 


1 


44 


a 


H 


72 


Q 


q 


17 


- 


45 


q 


I 


73 


R 


r 


18 




46 


□ 


J 


74 


s 


s 


19 


/ 


47 


Q 


K 


75 


T 


t 


20 





43 


□ 


L 


76 


U 


u 


21 


1 


49 


S 


Mi 


77 


V 


V 


22 


2 


50 





M 


78 


w 


w 


23 


3 


51 


n 





79 


X 


X 


24 


4 


52 


n 


P 


80 


Y 


y 


25 


5 


53 


■ 


a 


81 


Z 


z 


25 


6 


54 


□ 


R 


82 


[ 




27 


7 


55 


a 


s 


83 


E 




28 


8 


56 


E 


T 


84 


] 




29 


9 


57 


Q 


U 


85 


T 




30 


: 


58 


H 


V 


86 


4- 




31 

32 
33 


< 


59 
60 

61 




w 

X 

Y 


e^ 


I SPACE 


88 


! 


89 


ii 




34 


> 


62 


a 


z 


90 


# 




35 


■> 


63 


a 




91 


S 




36 


B 


64 


B 




92 
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SET 1 SET 2 


POKE 


SET1 


SET 2 


POKE 


SET 1 


SET 2 


POKE 


m 




93 


B 


S3 


105 


r 




117 


^ 


94 


□ 




106 


a 




118 


a i 


3 


95 
96 

97 


CB 
Ld 




107 

103 
109 


n 
n 
u 




119 


SPACE 


120 


U 


121 


H 




98 


E3 




110 


□ 





122 


n 




99 


□ 




111 


E 




123 


□ 




100 


ra 




112 


a 




124 


□ 




101 


H 




113 


H 




125 


H 




102 


H 




114 


D 




126 


□ 




103 


ffl 




115 


5 




127 


Q 




104 


D 




116 









Codes from 129-255 are reversed images of codes 0-127. 
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APPENDIX F 



ASCII AND CHR$ CODES 



This appeidix shows you what characters will appear if yoi PRINT 
CHR$''X!, for all possible values of X. It will also show the values ob- 
tained by typing PRINT ASCf'x"), where x is any character you can type. 
This is useful in evaluating the character received in a GET statement, 
converting upper/lower case, and printing character based commands 
(like switch to upper/lower case) that could not be enclosed in quotes. 



PRINTS CHRS 


PRINTS 


CHRS 


PRINTS 


CHRS 


PRINTS 


CHRS 





i'^f 1 


17 


- 


34 


3 


51 


1 


CM 

■Uhk 


18 


# 


35 


4 


52 


2 




19 


$ 


36 


5 


53 


3 


B3H 

Hon 


20 


% 


37 


6 


54 


4 




21 


& 


38 


7 


55 


j^^fc 




22 


■ 


39 


8 


56 


6 




23 


( 


40 


g 


S7 


7 




24 


) 


41 


: 


58 


DISA&LE$QQQ8 




25 


* 


42 


; 


59 


thABLtsEfflQS 




26 


+ 


43 


<^ 


60 


10 




27 


1 


44 


= 


61 


11 


flgfl 


28 


- 


45 


Z> 


62 


12 


iife' 


29 




46 


? 


63 


13 




30 

31 


1 



47 
48 


@ 
A 


64 
65 




15 


:«-:.:3 


32 


t 


49 


B 


66 


16 


! 


33 


2 


50 


C 


67 
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PRINTS 


CUPS 


PRINTS 


CURS 


PRINTS 


CHRS 


i PRINTS 


CHRS 


D 


68 


a 


97 





126 


ffl 


155 


E 


69 


m 


98 


a 


127 


m 


156 


F 


70 


b 


99 




126 


i ;!■*.*' 


157 


G 


71 


a 


100 


s 


12S 


fflk 


158 


H 


72 


3 


101 




130 


n 


159 


1 


73 


a 


102 




131 


E9 


160 


J 


74 


D 


103 




132 


D 


161 


K 


75 


□ 


104 


ti 


133 


.. 


162 


L 


76 


3 


105 


f3 
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163 


M 


77 


Q 


106 


f5 


135 


_ 


164 


N 


78 


Q 


107 


f7 


136 


D 


165 





79 


D 


108 


f2 


137 


§3 


166 


P 


80 


S 


109 


f4 


138 


□ 


167 


Q 


81 





110 


« 


139 


Mo 


168 


R 


82 


c 


111 


f8 


140 


B 


169 


S 


63 


■ 


112 


! ;:;; ''iffll 41 


□ 


170 


T 


84 


113 


l-oHjafi 


J 142 


ffl 


171 


U 


85 


□ 


114 




143 


, 


172 


V 


86 


a 


115 


A 


144 


B 


173 


W 


87 


D 


116 


^s 


145 


H 


174 


X 


86 


a 


117 


cm 


146 


_ 


175 


Y 


89 


El 


116 


B3B 


147 


E 


176 


Z 


90 





119 


C9 


148 


a 


177 


I 


91 


ffl 


I2D 


Q 


149 


E 


178 


£ 


92 


□ 


121 


H 


150 


k 


179 


] 


93 


ffl 


1 22 


O 


151 


D 


180 


T 


94 


ffl 


23 


a 


152 


c 


181 


- 


95 


B 


24 


□ 


153 


1 


182 


B 


96 


m 1 


25 


[S 


154 


n 


183 



136 



PRINTS 


CHR$ 


PRINTS 


CHRS 


PRINTS 


CHR$ 


PRINTS 


CHR» 


H 
U 


194 
185 


□ 


iee 

187 


H 


158 
1B9 


E3 
S 


190 
191 



COOES 


192-223 


SAME AS 


96-T27 


CODES 


224-254 


SAME AS 


160-190 


CODE 


255 


SAME AS 


126 
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APPENDIX G 



SCREEN AND COLOR MEMORY MAPS 



The following charts list which memory locations control placing char- 
acters on the screen, and the locations used to change individual char- 
acter colors, as well as showing character color codes. 

SCREEN MEMORY MAP 



MUINH 
70 



1024- 

1064 

1104 

1144 

llffl 

12» 

126.'- 

1304 

1344 

1334 

1424 

14S4 

1504 

1544 

1534 

1624 

■<iU 

1754 

1744 

1781 

i«a 
1864 
1904 

1944 
1984 













































































]Q63 












































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































- 
























































































































































































































































































































































































































































1 





t 

202} 



13S 



The actual values to POKE into a color memory location to change a 
character's color ore: 






BLACK 


1 


WHITE 


2 


RED 


3 


CYAN 


4 


PURPLE 


5 


GREEN 


6 


BLUE 


7 


YELLOW 



8 

9 

10 
11 
12 
13 

14 
15 



ORANGE 
BROWN 
Light RED 
GRAY 1 
GRAY 2 
Light GREEN 
Light BLLE 
GRAY 3 



For example, to change the color ol a character located at the upper 
left-hand corner of ths screen to red, type; POKE 55296,2. 

COLOR MEMORY MAP 



COLUMN 
20 



5529E- 

bb33E 

55376 

554IE 
55456 

55536 

55576 
55016 
55656 

55696 

55736 
5J77S 
55816 
55856 
::::: 

55936 

559/6 
5(0 IE 
58056 
5(096 
5(136 
561 7C 
5B21C 
5625E 



55335 











l_ ' ' 










1 ; 


! 












— 1— 


- - 


± 








± 





-0 2 



t 
5SK: 
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APPENDIX H 



DERIVING MATHEMATICAL FUNCTIONS 



Functions thct are not intrinsic to Commodore 64 BASIC may be calcu- 
Intecl as follows: 



FUNCTION 


BASIC EQU VALENT 


StCAN [ 


SfcC(X)=l/COS(Xt 


COSECANT 


csc{X)=usin;x) 


COTANGENT 


COT{X) = l/WN(X) 


INVERSE SINE 


ARCSIN(X) = AIN(X/SQB(-X*X+1)I 


INVERSE C05INE 


ARCCOS;X)= -ATN(X/SQR 




(— X*X +1)) +TTI2 


INVERSE SECANT 


ARC5EC(X)=A~N(X/SQR(X*X-1)J 


INVERSE COSECANT 


ARCC5C(X)=ATN;x/SQR(X*X - 1 » 




-(SGN(X)-T*r/2 


INVERSE COTANGENT 


ARCOT<X)=ATN(X)+tt/2 


HYPERBOLIC SINE 


SINH(X)=(EXPiX)-EXP!-X))/2 


HYPERBOLIC COSINE 


COSH(X)=(EXP(X)+EXP{-X))/2 


HYPERBOLIC TANGENT 


TANH(X)=EXP(-X>/(EX={x) + EXP 




(-X))*2+l 


HYPFRROIIC SFCANT 


SECH(X)=2i'(EXP(X) + EXP(-X)) 


HYPERBOIIC COSECANT 


C5CH|X)=?ftEXP(X)-EXP(-X)) 


HYPERBOLIC COTANGENT 


COrHIX)=EXP:-X)/(EXP(X) 




-EXP(-X))*2-H 


INVERSE HYPERBOLIC SINE 


ARCSINh{X) = lOG(X4-SQR{X*X4-l)} 


INVERSE HYPERBOLIC COSINE 


ARCCOSH(X)=LOG(X4SQR(X*X-l)) 


INVERSE HYPERBOLIC TANGENT 


ARCTANH(X)=LOG«1 +X)/<1 -X))/2 


INVERSE HYPERBOLIC SECANT 


ARCSECH(X)= .OG({SC>R 




<-X*X+')+l/X) 


INVERSE HYPERBOLIC COSECANT 


ARCeSCH(X)=LQG((SGN(XJ*5QR 




(K*X+l/« 


INVERSE HTERESOUC COTAM- 


ARCCOTHQ0=LOG((X+ 1 )!{*- 1 ))/2 


GEN" 
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APPENDIX I 



PINOUTS FOR INPUT/OUTPUT DEVICES 



This appendix is desiyned lu shuw you what connections may be 
made to the Commodore 64. 



1) Game I/O 

2) Cartridge Slot 
3} Audb/Video 



Control Port 1 



Pin 


Type 

JOYAO 


Note 


2 


J0YA1 




3 


JOYA2 




4 


J0YA3 




5 


por AY 




6 


BUTTOr>, A'LP 




7 


+ 5V 


MAX, 50mA 


8 


GtO 




9 


POT AX 





4) Serial I/O (Disk/Printer) 

5} Modulator Output 

6] Cassette 
7) User Port 


V. 


2 3 4 5 
O 

o o o / 
7 S 9 7 



Control Part 2 



Pin 


Typ* 

JOYBO 


Mete 


2 


JOYB1 




3 


J.QYB2 




4 


JOYB3 




5 


POT BY 




6 


BUTTON B 




7 


+ 5V 


MAX. 50mA 


B 


GND 




J 


POT BX 
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Cartridge Expansion Slot 



Fin 


Type 


12 
13 


BA 

DMA 


H 


D7 


15 


D6 


6 


D5 


17 


Di 


R 


nn 


<; 


D2 


20 


Dl 


21 


DO 


22 


GHD 



Pin 


Type 


N 


A<3 


P 


A8 


R 


A7 


5 


A* 


1 


A5 


U 


A4 


V 


A3 


W 


A2 


X. 


Al 


Y 


AO 


I 


GHD 



23 :1 X to 18 17 IB IS H 13 13 1110 9 S ' « ! » 3 5 I 



Z r HWVU'SFtPNMLKJHFEDCBA 

Audio/Video 



Pin 


Type 


1 


GND 


2 


+ SV 


3 
4 
5 


fSV 

IRQ 
R/W 


6 


Dot Clock 


7 


I/O 1 


8 


GAME 


9 


EXROM 


10 


I/O 2 


11 


KOMI 



Pin 


Type 


Nate 


1 


LUMINANCE 


2 


GND 




3 


AUDIO OUT 




4 


VIDEO OJT 




5 


AUDIO IN 





Serial I/O 




Pin 


Typ« 


1 


SERIAL SRQIN 


2 


GND 


3 


SERIAL ATN IN'OUT 


4 


SERIAL CLK IN/OUT 


5 


SERIAL DATA IN/OUT 


6 


RESET 



Pin 


Type 


A 


GND 


B 


RCMH 


C 


iLSLI 


D 


NASI 


E 


5 02 


F 


A15 


h 


Aid 


J 


A13 


K 


AI2 


L 


Al 1 


At 


AID 




142 



Cassette 



Pin 

A-T 


Type 


GND 


3-2 


+ SV 


C-3 


CASSETTE MOTOR 


D-4 


CASSETTE RFAD 


E-5 


CASSFTTF WRITE 


f-6 


CASSETTE SENSE 



12 3 4$ 



A fl C D E F 



User I/O 



Pin 


type 


Note 


1 


GND 




2 


\ W 


MAX. 100 mA 


3 


RESET 




4 


CNTt 




5 


SP1 




6 


CNT2 




7 


SF2 




8 


PC2 




9 


SER. ATN IN 




10 


9 VAC 


MAX 100 mi 


1 1 


9 \(ftC 


MAX. 100 mA 


12 


SND 





Pin 


Type 


Nate 


A 


END 




B 


TLAG2 




C 


PBO 




D 


PB1 




E 


PB2 




h 


pua 




H 


»B4 




J 


JB5 




K 


PB6 




L 


= 67 




M 


FA2 




N 


SND 





1 Z 3 4 5 6 7 S 9 10 11 12 



ABCDEFHJKLMM 
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APPENDIX J 



PROGRAMS TO TRY 



We've included a number of useful programs for you to try with your 
Commodore 64, Those prog'ams will prove both entertaining anc 
usefu . 
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100 fifi nf'Bjotto J i en hutterf i *td" 

120 input'Susnt I nstruct ions" -, z.% : i f asc ( z* > =?Sgotoii50 

130 prinf'EHry tu guess the* mystery 5-letLe 1 " word" 

140 (NT I nf'Byou must gutss only l^gal S-lett*r" 

153 pr i nt "uiords, too..." 

1&0 prinf'you u i 1 1 be told th* number of nstches" 

170 print" (oi* 'jots') cf your gu*;s." 

ISO pr i nt"£h i ftt! the trick is to vary slightly" 

193 print" from one guess to the next; so that" 

2Q0 print" i- you guess 'batch' ana get z jots" 

2 1 print" you Bight try 'botch' or 'chart'" 

220 print" f Qi~ th* n*>i-t Olrtft*** 11 

250 data bxbs- , i pccz ,dbd if ,«cf be, pggbtt 

2A0 data hpshf . i bud i ,d juj «n ,kpinm£, Ibzbl 

270 data sbkb i «mf wf «,n,jn jd, boof y, qjof s 

230 data rvf tu,sj uf s ,qsf tt ,puuf s, fuf ou 

290 data xfbw* ,f yuprii ,nvt iz,af cst>, gj aaz 

3O0 data ui jdl ,*5va I , gmppe,ujhFs, gb If s 

310 dsta cppu i , m« j oh, trvbu, hbvsf , pm joh 

320 data u i sf J , t J h i iu , bynaf t ,hsv^q , bs f ob 

330 data rubsu , dsf f q»c# nid i . qsf tt, tqbs.1 

343 data 5bebs,sv5bm ,ttif f««i,gspno, *s jgu 

400 n=50 

410 didi n»(n) ,z(5) ,y<5> 

420 for j=lton:readn*! j ) snext j 

430 t=ti 

440 t-t/1000; ift>-lth«.ngoto440 

450 a=rfid<-t> 

500 g=0mi=nt frnd< 1 )*n + l) 

510 print "Pi have a five letter wordi" : if r>0goto560 

520 print "guess (with legal words)" 

530 print "and i'tl tell you how many" 

540 print "'jots', or matching letter?," 

550 print "you hsvf,.. ." 

540 g-g+li input "your word%i* 

R70 if \&n I ?4 ) < "'fit h^npr i nt. IJ y rtu wu*it guf>«;s 3 

5-letter word ! " : goto560 

580 v=0:h=0:«t=0 

590 forj=lto3 

£00 2-ascfu id*(z*, j , 1) >iy = 35C (m id*( n*, j , 1 ) >-l s i f y=i4theny=90 

610 i fz<;65orz>90thenpr inf'that' s not a word ! " : goto5A0 

420 i fz = 65or2 = 6?orZ'*73i,r'£«7?urE-S5or£»S?th«nv«vTl 

&30 i f==uthi?niii-«iJ-l 

440 t ( j > = 7 : ij ( j ) = ij; newt j 

450 i fra=5qota400 

460 i fv = 0orv = 5t t renpr int" com* on. .what kind of 

a word is that?" : qotoSiO 

670 for j=lto5:y=y I j ) 

680 for k=lto5 : i f y=z<k) thenh-liri : z( k ) =O;goto70O 

490 ne-Kt h 

700 n^Mt j 

710 pi-ir.t , 'n0DBEi]D(3flrnFlFlHBHfinnG" ;H;"JQTS" 

720 ifg<:3Qgeto560 

730 pr i rt" i * d better tell you., word us; '"; 

740 f or j = l to5 ;$jr i ntchr t ( q ( j ) > , snext j 

7bO pri nt"'":gotoaiO 

aOO prinf'you got it in on ly" ;g ;" guesses . " 

S10 i npiit"? another word" ,2* 

820 r> = l : i fsjc ( 2* ) <>7Sgot o50O 
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1 rem **K seguenct 

2 rem 

3 rem w#w from pet user group 

4 rew *£ft sof twsr* exchange 

5 re« *** po box 371 

4 rem *** MDntgomeryv I I le , ps 1S936 

7 rem 

50 din at (26) 

100 zi="3bcdef ghi jra&inopqr&tuvwxijz" 

110 Z lt="l 23 4&6/89C1 234=0 7S90 1234 S6" 

200 prfnt"3PHfnier lenotb of 5trinq "to tie- sequenCtdEI" 

220 incut "'iisj-; i »m» lernlh is 24 "fsj 

7X0 if sSKl or mX>;'6 the-n ?00 

240 s=si 

300 for i=l to 5 

310 aft i )=mid*(z*. i ,1> 

320 next I 

400 r- t-iti f-dri Juni i if string 

120 for- 1=1 to ■ 

430 k=int (rid( l)*s+l) 

440 tl=3*( i ) 

450 ail i )=a*<k> 

460 a1Ck)=tH 

470 n*xt I 

4S0 OOSUb 950 

S95 t=0 

&00 rerrt i"*v=-r£~ &ul:-E t I* i no. 

i05 t=t+l 

610 input "low nanu to re-verse " ; rX 

620 if rX=0 goto 900 

630 if r%>0 and r%<. = s goto 650 

640 print "Must be betuovrt 1 and "jss goto 610 

650 r=int(rK/2> 

440 for i=l to r 

670 t»=at( i ) 

6S0 s1E i >«a*<rX-i+l> 

690 BttrZ-i+l >=t* 

700 next i 

7SiO gosuc. Vio 

a(J0 c-l 3 for i -2 tc * 

SIO If 3*( i >>a*( i-l> goto 330 

»20 c = 

S30 next i 

840 if c=0 goto 600 

S50 print "Pyou did it in "it;" tries 1 ' 

?C0 rem che:k for another gain* 

910 input "Pwajrit to play sgaijn " -, y# 

920 if l*f tt ( yt , 1 J ="ij" of y*="ok" or y*="l" qoto 200 

930 end 

950 pr i nt 

960 print lef t«< zl *, s> 

970 for i = l to s: print a* ( i ) ; ;ne>:t i 

?eo print "3" 

990 return 

This program courtesy of Gene Deals 



146 



38 REM PIRHO KEVBOfiRD 

ie® print's a m ini i a 111 hi i a a 1 in »» " 

118 PRINT" S » M I ill II tiJ i U 93 I 111 U " 

120 PRINT" 3 91 to I U ifj Sil 1 *1 ILI ! W Hi " 

130 PRINT" 1 I I I I I I I I I I ! I " 

148 PRINT" as |W IE [ft ]T |V |U |1 |0 IP is I* |+" 

ISO PRINT "B'SPflCE' FOR SOLO OR POLVPHON I C " 

i€3 PRIMT'-S'Fl ,F3.-F5.-F7' OCTRVE SELECTION" 

170 PRtHT"a'P3.-F4.FS>FS' WAVEFORMS" 

130 PRINT "HIRNG OH, SETTING UP FREQUENCY TABLE. . . " 

190 S-13*4096+ie£4sDIMP<26) iDIftK<2553 

288 FORI=0Tij23iFOKE3+r. r Q :NEXT 

210 Flw7040 lFORI-1 ! 02:6 :F'".27-I >»Fl*5,S+30 lFIwFl/2'f < i.f"12? sNEXT 

2SS K*» ,, O2W3ER5 T SV7UI90®P@-*£1 v " 

230 FOR I = IT0LGH (I-:*:? sK<P'SC<HI0#?K#,I>>)-I =HEXT 

24t3 FRIMT"I] 

250 flT=0:CE=0 :SLI= L 5 < RE»? ;5« -SU* 1S+RE i AV=HT*1 S+DE : 

WV=li :H=0 iM = i :0C:=4 :HE:=25C ;Z-^e 

258 F0RI«QTC£sP0KE3^5+I*r r HT»iS+0EjPOKES+6*I#7,SUi*iSi-RE 

270 P0K!ES+2+I*7.. 4.803FIHD25S : P0KES+3+I*? . 4000/356 I H EXT 

28@ PQKES+23., 15 :REM+. 16+64 :PaKES+23,7 

330 GETRS:IFft*= M "THEM3Q0 

31S FR-F£1«:fleC<ft#> 5 :>r J M >T-V«I7 iCR-B-i-T+4 i IFFR-ST-IGHEtjO 

'220 PQKES+£+T,Z:REF'1 FINISH DEC.-'SJS 

325 P0K:ES+5+T..Z;REM FINISH RTT/REL 

330 POKECR,8iPQKECR:,05REM FIX 0F= 

340 P0KES+T,.FR-HEWIHT'::FR,-'HE> :REH 'SET LO 

350 PCiKES+l+T,FR,.'HEiREM SET HI 

360 POKES+6+TjSViREM SET DEC/SUS 

365 POKES+5+T..FlV i REM SET RTT/REL 

373 PpKECR.-W'Jn-l iF0RI-4TQ5Q*ftTtNEXT 

375 PGKECR,kV:REM PULSE 

380 IFP=lTHEHV=V+i : IF'V=3THENV=9 

4£iO GOT 03 SO 

500 IFR*="i"THEHE-l= 1 iOC-4 :OOTO300 

510 I Ffl*= l, H"THE»M = 2 : 0C=s3 S GOTO380 

520 [Fft*™"II"THENM«t4iOC=£ BO0T0398 

52-0 IFR*= ,, BI"THEMT1 = 3!0C=1 ;COTO30O 

540 EFfMs» n H"THeNW-»@sUy-lS -OCiTO230 

350 IF=l*-="K"THEMW«l iNV=32 :COTO30O 

550 [FB*="M"THEHU=2:WV=6«« : 0010300 

S76 IF=l*- ,, irTHENW = 3iUV=123 iGQTO390 

530 IFBfe" "THEMP = l-P:ei:iTQ30B 

330 IF=l*="a"THEN2.«i0 

^ri^i^ G0TQ3190 

see priht"hit r kgv 

310 GETfi'$:IFfl*=" " THEN810 ;UIFi I T FOR R KEV 
920 FRIMTFWsRETURN 

NOTES; 

Una 100 uses ISHIFT CLRiHOME), Line 530 uses <IT> 

(CTRL 9),(CTRL D.fSHIFT B). Line 540 uses (12) 

Line IbU uses ICRSR DOWN) Line S)0 uses (14) 

Line 240 uses iCRSP UP) Line &60 uses (16) 

Line 500 uses IN) Line 570 uses (18) 

Line S10 uses |f3) Line 5S0 uses (SHIFT CLR/HOME} 

Line 520 uses I f 5 ) 
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APPENDIX K 



CONVERTING STANDARD 
BASIC PROGRAMS TO 
COMMODORE 64 BASIC 



If- you have programs written in a BASIC other than Commodore 
BASIC, some minor adjustments may be necessary before running them 
on the Commodore-64. We've included some hints to make the conver- 
sion easier. 

String Dimensions 

Delete all state merits that ore used to declare the length of strirgj. A 
statement such as DIM A$(I,J), which dimensions a string array for J 
elements of length I, should be converted to the Commodore BASIC 
statement DIM A$(J). 

Some BASICs use a comma or ampersand for string concatenation. 
Each of these must be changed to a plus sign, v/hich is the Commodore 
BA5IC operator for string concatenation. 

In Commodore-64 BASIC, the MID$, RIGHT$, and LEFT$ functions are 
used to take substrings of strings. Forms such as A$(l) to access the Ith 
character in A$, or A$(l r J) to take a substring of A£ -from position I to J, 
must be changed as follows; 

Other BASIC Commodore 64 BASIC 

A$(l) = X$ A$ = LEFT$(AS,[-1)+X$+MID$(A$,I+1) 

A$(I,J) = X$ A$ = LEFT$(A$,l-l)+X$ + MID$(A$,j+l) 

Multiple Assignments 

Ts set B and C equal to zero, some BASICs allow statements of the 
form: 

10 LET B=C=0 
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Commodore 64 BASIC would interpret the second equal sign as a 
loglcnl operator ond set R = — 1 H C = 0. Instead, convert this state- 
ment to; 

10 C = : B = 

Multiple Statements 

Some BASICS use a backslash (\ ) to separate multiple statements on 
a line. With Commodore 64 BASIC, separate all statements by a colon 

CO- 
MAT Functions 

Programs using the MAT functions avoilable on some BASICs must be 
rewritten using FOR. . .NEXT loops to execute properly. 
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APPENDIX L 



ERROR MESSAGES 



This appendix contains a complete list of the error messages gener- 
ated by the Commodore-64, with a description ot causes. 

BAD DATA String data was received from an open file, but the pro- 
gram was expecting numeric data. 

BAD SUBSCRIPT The program was trying to reference an element of 
an array whose number is outside of the range specified in ihe DIM 
statement. 

CANT CONTINUE The CONT command will not work, either because 
the program was never RUN, thar» has been an error, or n line has 
been ediled. 

DEVICE NOT PRESENT The required I/O device was not available for 
an OPEN, CLOSE, CMD, PRINT*, INPUT*, or GET#. 
DIVISION BY ZERO Division by zero is a mathematical oddity and not 
allowed. 

EXTRA IGNORED Too many items of data were typed in response to 
an INPUT statement. Only the first few items were accepted. 
FILE NOT FOUND If you were looking for a file on tape, and END-OF- 
TAPE marker was found. If you were looking on disk, no file wi-h that 
name exists. 

FILE NOT OPEN The file specified in a CLOSE, CMD, PRINT#, IIMPUT#, 
or GET#, must first be OPENed. 

FILE OPEN An attempt was made to open o file using the number of 
un already open Rle, 

FORMULA TOO COMPLEX The string expression being evaluated 
shoLld be split into ot least two parts for the system to work with, or a 
formula has too many parentheses. 

ILLEGAL DIRECT The INPUT statement can only be used within a pro- 
gram, and not in direct mode. 

ILLEGAL QUANTITY A number used as the argument of a function or 
statement is out of rh« allowable range. 
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LOAD There is a problem with the program on tope, 
NEXT WITHOUT FOR This is caused by either incorrectly nesting loops 
or having a variable name in a NEXT statement that doesn't correspond 
with one in a FOR Btotement. 

NOT INPUT FILE An attempt was made to INPUT or GET oata from a 
file which was specified to be for output only, 

NOT OUTPUT FILE An attempt was made to PRINT data to a file which 
was specified as input only. 

OUT OF DATA A 3EAD statement was executed but there is no data 
left unREAD in a DATA statement. 

OUT OF MEMORY There is no mors RAM ovoiloble for program or 
variables. This may also occur when too many FOR loops have been 
nested, or when there are too many GOSUBs in effect. 
OVERFLOW The result of a computation is larger than the largest 
number allowed, which is. 1 70U1 8S4E + 38. 

REDIM'D ARRAY An array may only be DIMensioned once. If an array 
variable is used before that array is DIM'd, Oti automatic DIM operation 
is performed on that array setting the number of elemen-s to ten, and 
any subsequent DIMs will cause this error. 

REDO FROM START Character date was typed in during an INPUT 
statement when numeric data was expected. Just re-type the entry so 
that it is correct, and the program will continue by itself. 
RETURN WITHOUT GOSUB A RETURN statement was encountered, 
and no GOSUB command has been issued. 

STRING TOO LONG A string con contain up to 255 characters. 
?SYNTAX ERROR A statement is unrecognizable by the Commodore 
64. A missing or extra parenthesis, misspelled keywords, ere. 
TYPE MISMATCH This error occurs when a number is used in place of a 
string, or vice-ve'sa. 

UNDEF'D FUNCTION A user defined function was referenced, but it 
has never been defined using the DEF FN slatement. 
UNDEF'D STATEMENT An attempt was mode to GOTO or GOSUB or 
RUN a line number thul doesn't exist, 

VERIFY The program on tape or disk does not match the program cur- 
rently in memory. 
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APPENDIX M 



MUSIC NOTE VALUES 



This aopendrx contains a complete list of Mote#, actual note, end tie 
values to be PDKEd into ihe HI FREQ and _OW FREQ registers of the 
sound chip to produce the indicated lofe. 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 





C-0 


268 




12 


1 


C#-0 


284 




28 


2 


D-0 


301 




45 


3 


D#-0 


318 




62 


A 


E-0 


337 




81 


5 


F-0 


358 




102 


6 


F#-0 


379 




123 


7 


G-0 


401 




145 


B 


G#-0 


425 




169 


9 


A-0 


451 




195 


10 


A#-0 


477 




221 


11 


B-0 


506 




250 


16 


C-l 


536 


2 


24 


17 


C#-l 


568 


2 


56 


18 


D-' 


602 


2 


90 


19 


D#-l 


637 


2 


125 


20 


E-l 


675 


2 


163 


21 


F-l 


76 


2 


204 


22 


F#-l 


758 


2 


246 


23 


G-l 


803 


3 


35 


24 


G#-l 


851 


3 


83 


25 


A-l 


902 


3 


134 


26 


A#-l 


955 


3 


187 


27 


B-l 


1012 


3 


244 


32 


C-2 


1072 


4 


48 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


33 


C#-2 


1136 


4 


112 


34 


D-2 


1204 


4 


180 


35 


D#-2 


1275 


4 


251 


36 


E-2 


1351 


5 


71 


37 


F-2 


1432 


5 


152 


38 


F#-2 


1517 


5 


237 


39 


G-2 


1607 


6 


71 


40 


G#-2 


1703 


6 


167 


41 


A-2 


1804 


7 


12 


42 


A#-2 


1911 


7 


119 


43 


B-2 


2025 


7 


233 


48 


C-3 


2145 


8 


97 


49 


C#-3 


22/3 


8 


225 


50 


D-3 


2403 


9 


104 


51 


D#-3 


2551 


9 


247 


52 


E 3 


2703 


10 


143 


53 


F-3 


2864 


1 1 


48 


54 


F#-3 


3034 


11 


218 


55 


G-3 


3215 


12 


143 


56 


G#-3 


3-106 


13 


7S 


57 


A-3 


360S 


14 


24 


58 


A#-3 


3823 


14 


239 


59 


B-3 


4050 


15 


21D 


64 


C-4 


4291 


16 


195 


65 


C#-4 


4547 


17 


195 


66 


D-4 


4817 


18 


209 


67 


D#-4 


5103 


19 


239 


68 


E-4 


5407 


21 


31 


69 


F-4 


5723 


22 


96 


70 


F#-4 


6069 


23 


181 


71 


G-4 


6430 


25 


30 


72 


G#-4 


6812 


26 


156 


73 


A 4 


7217 


28 


49 


74 


A#-4 


7647 


29 


223 


75 


B-4 


8101 


31 


165 


80 


C-5 


8583 


33 


135 


81 


C#-5 


9094 


35 


134 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


82 


C-0 


9634 


37 


162 


83 


C#-0 


10207 


39 


223 


84 


D-0 


10814 


42 


62 


85 


F-5 


11457 


44 


193 


86 


F*-5 


12139 


47 


107 


87 


G-5 


12860 


50 


60 


83 


G#-5 


13625 


53 


57 


89 


A-5 


14435 


56 


99 


90 


A#-5 


15294 


59 


190 


91 


B-5 


16203 


63 


75 


96 


C-6 


1/167 


67 


15 


97 


C#-6 


18188 


71 


12 


9B 


D-6 


19269 


75 


69 


99 


D#-6 


20415 


79 


191 


100 


E-6 


21629 


84 


125 


101 


f-6 


22915 


89 


131 


102 


F#-6 


24278 


94 


214 


103 


G-6 


25721 


100 


121 


104 


G#-6 


27251 


106 


115 


105 


A- 6 


28871 


112 


199 


106 


A#-6 


30588 


119 


124 


107 


B-6 


32407 


126 


151 


112 


C-7 


34334 


134 


30 


113 


C#-7 


36376 


142 


24 


114 


D-7 


3B539 


150 


139 


115 


D#-7 


40830 


159 


126 


116 


E-7 


43258 


163 


250 


117 


F-7 


45830 


179 


6 


118 


F#-7 


48556 


189 


172 


119 


G-7 


51443 


200 


243 


120 


G#-7 


54502 


212 


230 


121 


A- 7 


57743 


225 


143 


122 


A#-7 


61176 


238 


248 


123 


B-7 


64814 


253 


46 
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FILTER SETTINGS 



Location 


Contents 


54293 


Low cutoff frequency (0-7) 


54294 


High cutoff frequency (C-255) 


54295 


Resonance (bits 4—7) 




Filter voice 3 (bit 2) 




Filter voice 2 (bit 1) 




Filter voice 1 (bit 0) 


54296 


High pass (bit 6) 




Bandpass (bit 5) 




Low pass (bit 4) 




Volume (bits 0-3> 
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APPENDIX N 



BIBLIOGRAPHY 



Addison- Wesley 

Compute 

Cowboy Computing 



"BASIC and the Personal Computer", Dwyer 
and Critchfield 

"Compute's First Book of PET/CBM" 

"Feed Me, I'm Your PET Computer", Carol Al- 
exander 

"Looking Good with Your PET", Carol Alexan- 
der 

"Teacher's PET — Plans, Quizzes, and An- 
swers" 



Creative Computing "Getting Acquainted With Ymr VIC 20", 

T. Hartncll 



Dllithium Press 



"BASIC Basic-English Dictionary for the PET", 
Larry Noonan 

"PET BASIC", Tom Rugg and Phil Feldman 



Faulk Baker Associates '7AOS Programming Mcnual", MOS Techno - 

ogy 



Hayden Book Co, 



"BASIC From the Ground Up", David E. Simon 

"\ Speak BASIC to My PET", Aubrey Jones, Jr. 

"Library of PET Subroutines", Nick Hampshire 

"PET Graphics", Nkk Hampshire 

"BASIC Conversions Handbook, Apple, TR$- 
80, and PET", David A. Brain, Phillip R. 
Oviatt, Paul J. Paquin, and Chcndler P, Stone 
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Howard W. Sarm 



Little, Brown & Co. 



McGraw-Hill 



Osborne/ McGraw-Hill 



P. C. Publications 



"The Howard W. 5ams Crash Course in Mi- 
crocomputers", Louis E, Frenzel, Jr. 

"Mostly BASIC: Applications for Your PET", 
Howard Berenbon 

"PET fn-erfacing", James AA. Downey and S r e- 
ven M. Rogers 

"VIC 20 Programmer's Reference Guide", A. 
Finkel, P. Hieginbottom, IN. Harris, and M. 
Tornc^yk 

"Computer Games for Businesses, Schools, 
and Homes", J. Victor Nagigian, and William 
S. Hodges 

"The Computer Tutor: Learning Activities for 
Homes and Schools", Gary W. Orwig, Univer- 
sity of Central Florida, and William S. Hodges 

"Hands-On BASIC With a PET", Herbert D. 
Pe-ckiman 

"Home and Office Use of VisiCalc", D. 
Castlewiti, and L. Chisauki 

"PET/CBM Personal Computer Guide", Carroll 
S. Donahue 

"PET Fun and Games", R. Jeffries and G. 
Fisher 

"PET and the IEEE' J , A. Osborne and C. 
Donahue 

"Some Common BASIC Programs for the PET", 
L. Poole, AA. Borchers, and C. Donahue 

"Osborne CP/M User Guide", Thorn Hogan 

"CBM Professional Computer Guide" 

"The PET Personal Guide" 

"The 8086 Book", Russell Rector and George 
Alexy 

"Seginrwng Self-Teaching Computer Lessons" 
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Prentice-Hall 



Reston Publishing Co. 



Telmas Courseware 
Ratings 

Tota' Information Ser- 
vices 



"The PET Personal Computer for Beginners", 
S. Dunn and V. Morgan 

"PET and the IEEE 488 Bus (GPIB)", Eugene 
Fisher and C, W. Jensen 

"PET BASIC — Training Your PET Computer", 
Ramon Zamora, Wm F. Carrie, and B. 
Allbrecht 

"PET Games and Recreation", M. Ogelsby, L. 
Lindsty, and D. Kunkin 

"PET BASIC", Richord Huskcll 

"VIC Games and Recreation" 

"BASIC and the Personal Computer", T. A. 
Dwycr, and M, Crrchficld 

"Understanding Your PET/CBM, Vol. 1, BASIC 
Programming" 

"Understanding Your VIC", David Schultz 



Commodore Magazines provide you with the most up-to-date infor- 
mation for your Commodore 64. Two of the most popular publications 

that you should seriously consider subscribing 10 are: 

COMMODORE — Trie A/lrcrueompufer Magazine is published bi-monthly 
and is available by subscription ($15.00 per year, U.S., and $25.00 per 
year, worldwide). 

POWER/PLAY — Ffie Home Computer Magazine is published quarterly 
and is available by subscription ($10.00 per year, U.S., and $15.00 per 
year worldwide). 
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APPENDIX 



SPRITE REGISTER MAP 



Dec Hex 


CB7 


DM> 


DBS 


DB4 


DB3 


DB2 


DB1 


DBO 






1 1 

2 2 

3 3 

4 4 


50X7 














SOXO 


SHKIlb X 
Comporent 


SOY7 














S0Y3 SFRITE Y 

Component 


S1X7 












SlXO SPRITE 1 X 


S1Y7 












SI YD SPRTE 1 Y 


S2X7 












S2X0 SPRITE 2 X 


5 5 


32 Y7 












ESYD SPRITE 2 Y 


6 6 


53X7 












S3X0 SPRITE 3 X 


7 7 

a a 

9 9 

10 A 
1 1 B 

12 C 

13 D 

14 E 

15 F 

16 10 

17 11 

18 12 
1? 13 
20 14 


53 Y7 












53Y0 


SPRITE 3 Y 


S4X7 












S4X0 


SPRITE 4 X 


S4Y7 












S4Y0 


SPRTE i V 


S5X7 










S5X0 


SFRl'E J X 


S5Y7 














55 YD 


SPRITE 5 Y 


S6X7 














S6X0 


SPRTE (j X 


56Y7 














56 YO 


SPRITE 6 Y 


S7X7 














57X0 


SPRITE 7 X 
Component 


S7Y7 














S7Y0 


SPRITE 7 Y 

Component 


57X8 


S6X8 


S5X8 


54X8 


53X8 


S2X8 


StXS 


soxe 


MSB of X 
COORD. 


RC8 


ECM 


RW,M 


5LNK 


RSEL 


YSCL2 


YSCL1 


YSCLO 


Y SCROLL 
MODE 


RC7 


RC6 


RC5 


RC4 


RC3 


RC2 


RC1 


RCO 


RASTER 
LIGHT PEN X 


LPX7 














IPXO 


LPY7 














IPYO 


LIGHT PEN Y 
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Register 
Dec 


# 
Hen 


DBT 


DBci 


DBS 


DB4 


DBJ 


DBS 


DB1 


DBO 




21 


15 


SE7 














SEO 


SPRITE 
ENABLE 


22 
33 


16 
17 


















(ON,'OFF) 


N.C. 
5EXY7 


N.C. 


RST 


MCM 


CSEL 


XSCL2 


XSCL1 


KSCLO 


X SCROLL 
MOPE 












5EXY0 


SPRITE 


li. 


18 


















EXPAND V 


VS13 


VS12 


VS1 1 


VS10 


CB13 


CB12 


CB11 


N.C. 


SCREEN 






















Character 1 






















Memory 


25 


19 


IRQ 


N.C. 


N.C. 


N.C. 


LPIRQ 


ISSC 


[SBC 


RIRQ 


Interup- 


1& 


1A 


















Requesh's 


M.C. 


N.C. 


N.C. 


N.C. 


,WLPI 


MISSC 


MISBC 


MR RQ 


Ihtefup" 






















Request 


17 


IB 


















MASKS 


6SP7 














BSPO 


Backgroynd- 


20 


1C 


















Sprite 

PRIORPY 


5CM7 














5CM0 


MULTICOLOR 






















SPRITE 


29 


ID 
















SELECT 


SEXX7 












SEXXO 


SPRITE 


30 


It 
















EXPAND X 


ssc; 














SSCO 


Sprite-Sprite 


31 


IF 


















COLLISION 


SBC7 














SBCO 


Sprite- 






















Bfli-kgrAiinH 






















COIIISION 



ISO 









COLOR CODES 


DEC 


HEX 


COLOR 


32 

33 
34 

35 
36 
37 

ii 
3? 
40 
41 
42 
43 
44 

46 


20 

21 
22 
23 

24 

25 

26 

27 
28 
29 
2A 
2B 
2C 

2D 

2E 


C 

1 
1 
3 

4 

5 

7 


BLACK 
WHIIE 

2 RED 

3 CYAN 

4 PLRPLE 

5 GREEN 

6 EiLUL 

7 YELLOW 


EXT 1 








EXTERIOR COL 


EKGDO 










EKGDt 










bkgd; 










EKGD3 










SMC 








SPRITE 
MJLTICOLOR0 


SMC 1 








1 


S0COL 








SPRITE COLOR 


8 

•o 
" 1 

■2 

13 

14 
15 


8 ORANGE 

9 BROWN 
A LT RED 
B GRAY 1 
C GRAY 2 
D LT GREEN 

E LT BLUE 
F GRAY 3 . 


51 COL 








1 


sacoL 








2 


S3COL 








3 


S4COL 








A 


S5COL 








5 


f,6cai 








4 


S7COL 








7 













LEGEND; 

ONLY CCLORS 0-7 WAV BE USED IN MULTICOLOR CHARACTER MODE 
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APPENDIX P 



COMMODORE 64 SOUND CONTROL 
SETTINGS 



This handy table gives you the key numbers you need to use in your 
sound programs, according to which of the Commodore 64 : s 3 voices 
you want to use. To set or ad jus- a sound control in your BASIC pro- 
gram, just POKE the number from the second column, followed by a 
comma (,) and a number from the chart . . . like tnis: POKE 54276,17 
(Selects o Triangle Waveform for VOICE 1). 

Remember that you must set the VOLUME before you can generate 
sound. POKE54296 followed by a number from to 1 5 sets the volume 
for all i voices. 

It take; 2 separate POKEs to generate eoch musical note ... for 
example POKE54273,34:POKE54272,75 designates low C in the sample 
scale below. 

Also . . . you aren't limited to the numbers shown in the tables. If 34 
doesn't sound "right" for a low C„ try 35. To provide o higher SUSTAIN 
or ATTACK 'ate than those shown, odd two or more SUSTAIN numbers 
together. (Examples: POKE54277,96 combines two aftcck rates (32 and 
64) for a combined higher attack rate . . . tut . . . POKE54277,20 
provides o low attack rate (16) and a medium decay rote (4). 



16? 



| SETTING VOLUME— SAME FOR ALL 3 VOICES 


| VOLUM6 CONTROL |pOKEi«9s| Saltings i-ono,. from (off) to 15 (ioud.i>) 


^B^HB^AIiH 


TO CONTROL 
THIS SETTING: 


POKE THIS 
NUMBER: 


FOLLOWtD BT ONE OF THESE NUMBERS 
(0 to 15 . . . or r . r Q to 255 dtptnding on rang*) 


TO PLAY A NOTE 


C 


C# 


D 


DM 


E 


F 


F#t <3 


G# 


A 


A# 


B 


C 


C# 


HIGH FREQUENCY 


{4273 34 


36 


M 


40 


43 


45 


48 51 


54 


57 


61 


64 


68 


72 


LOW FREQUENCY 


54272 75 


B5 


124 


100 


52 


i?e 


1S7 [p7 


111 


172 


14 


iss 


149 


149 


WAVEFORM 


POKE 


TRIANGLE 


SAWTOOTH PYL5E 


NOISE 




5427* 


17 


33 65 


12? 


PULSE RATE (Puis* 


A'et^form) 






HI PULSE 
LO PULSE 


54273 
54274 


A talv 

A .'u..j 


t o'" Q I 


a 15 (for 
3 255 (ft 


Pulse w 

jr Kulse 


avsfcrn 


cnlyP 

■n only) 






ArTACt'DeeAV 


POKE 


ATK4 


iTKI 


ATKi 


ATK1 


OEC4 


DEC3 


DECS 


DEC1 


5427? 


123 


44 


32 


16 


8 


4 


2 


1 


SUSTAIN/RELEASE 


POKE 
54278 


SUS4 
1 20 


SUS3 


SUSS 
M 


SUS1 
'4 


RE 14 
S 


1EL3 

4 


REL2 
2 


REL1 
1 




NUME 










TO PLAY A NOTE 


C 


C# 


D 


DM 


E 


F 

4j 

108 


48 
127 


G 

51 


3# 

34 
111 


A 


A# 


B 


C 


C* 


HIGH FREQUENCY 
LOW FREQUENCY 


541*0 34 
5427P 7{ 


34 

Si 


35 

lit 


40 

200 


43 
Si 


57 

179 


41 
J6 


44 

IBS 


SS 

149 


72 
149 


WAVEFORM 


POKE 






TRIAh 


OLE 


SAW 


rooi 


H 1 PULSE 


NOISE 






54283 


17 


33 65 | 12? 


PJLSE RATE 






HI PULSE 
LO PULSE 


54282 
342 01 


A vnlus of Id 15 (fur Pulls *avtferm only} 
A voIjb of to 2£5 (for Puis* nwKwfWm only) 




ATTACK/DECAY 


POKS 


ATK4 


ATK3 


ATK2 


ATKl 


D5CJ 


DEC3 


MCI 


DEC1 


51284 


128 


64 


32 


16 


8 


4 


2 


j 


SUSTAIM/RELElSE 


POKE 
$4285 


SUS4 
138 


SUS3 
44 


5US2 

3; 


SUS1 
16 


R.EL4 
S 


RE13 

4 


REL2 
2 


REL1 
1 
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|^^^^B^Pe*3 


TO PLAY A NOTE 


c 


c# 


D 


D* 1 


E 


F 


F# 


G 


G# 


A 


A# 


B 


C 


C# 


HIGH FREQUENCY 


5-1237 34 


36 


3B 


40 


43 


45 


48 


31 


54 


37 


61 


64 


68 


72 
149 


LOW FREQUENCY 


5428-J 75 


as 


126 


200 


52 


158 


127 


97 




111 


172 


126 


166 


149 


WAVEFORM 


»OKE 


TR ANGLE 


SAWTOOTH 




FULSE 




NOISE 




34 IPO 


17 


33 


is 


129 


PU15E RATE 


S4799 
J42S8 








Ml PUISE 

LO PULES 


A value of u To 15 {for Pulte waveform onlv] 
A value of to 25$ (lor Puli^ waveform only) 


ATTACK/DECAY 


POKE 


ATM 


AK3 


ATM t ATK1 1 DIC4 


DEC3 


DEC2 


DEC1 


J42?: 


1ZS 


64 


12 lo 9 


4 


2 


1 


SUSTAIN/RELEASE 


POKE 


SUS4 
128 


SUS3 

64 


SUS2 1 SUS1 1 REL4 

33 is | a 


RE .3 

4 


RE LI 
9 


REL1 
1 



TRY THESE 


SETTINGS TO SIMULATE DIFFERENT INSTRUMENTS 


Jnstrumeit 


Waveform 


Attack/ Decay 


Sustain/Release 


Pulse Rote 


Piano 


Pulse 


? 





Hi-0, Lo-255 


Mute 


Trioncje 


96 





Nat applicable 


Hcrpsichord 


Sawtooth 


9 





Not applicable 


Xylophone 


Triangle 


? 





Not applicable 


Organ 


Triangle 





240 


Not applicable 


CnJIiaps 


Triangle 





240 


Not applicable 


Aeirnrdtan 


Triangle 


102 





Not cpplicable 


Trumppt 


Snwtnrtth 


96 





Nat cpplicable 



MEANINGS OF SOUND TERMS 

ADSR — A»+a c:k/Cl«t4.y/5wf*a ! rv/BeU^** 

Am± c Ii — •'fm **^n^ *■*«■ ie pi*flk vdlumi 

Decay — rale uund falls from peat w^lym* +c Suil^ln Ih**I 

Sustain prolong note at terrain volume- 

Re I tote — rale at wtikb valumii foil* Iron* aujtgir lenel 

VY cure form — "ifccrpt" qt <■";•., -i ; wnrt 

TulHr — Ton* quality of fuho Wara-farm 

NOTE; Attack/Decay and Sustufn/Releuse se-tHr y* should rjtwuys be- POKEd In yu-ur piuyiuin 
BEFORE The Waveform is POKEd. 
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INDEX 



Abbreviations, BASIC commands, 130, 

131 
Accessories, viii, 106-103 
Addition, 23, 26-27, 1 13 
AND operator, 114 
Animation, 43-44, 65-66, 69-75, 132, 

13S-139 
Arithmetic, Operators, 23, 26-27, 

113-114 
Arithmetic, Formulas, 23, 26-27, 113, 

120, 140 
Arrays, 95-103 
ASC function, 128, 135-137 
ASCII character codes, 135-137 

B 
BASIC 

abbreviations, 130-131 

commands, 114-117 

numeric functions, 125-127 

operators, 113-114 

other functions, 129 

statements, 1 17-125 

string -functions, 128 

variables, 112-113 
Bibliography, 156-15B 
Binary arithmetic, 75-77 
Bit, 75-76 
Business aids, 108 
Byte, 76 

c 

Calculations, 22-29 

Cassette tape recorder (audic), viii, 3, 

18-20, 21 
Cassette tape recorder (video), 7 
Cassette, port 3 
CHR$ function, 36-37, 46-47, 53, 

58-60, 113, 128, 135-137, 148 
CLR statement, 117 
CLR/HOME key, 15 
Clock, 113 

CLOSE statement, 117 
Color 

adjustment, 1 1-12 

CHRt cedes, 58 

keys, 56-57 

memory map, 64, 139 

PEEKS and POKES, 60-61 

screen and border, 60-63, 1 38 



Commands, BASIC, 1 14-1 17 
Commodore key, [see graphics keys) 
Connections 
optional, 6-7 

rear, 2-3 

side pane,, 2 

TWMonftor, 3-5 
CONT command, 114 
ConTffL key, 11, 16 
COSine function, 126 
CuRSoR keys, 10, 15 
Correcting errors, 34 
Cursor, 10 



DATA55ETTE recorder, (see cassette 
tape recorder) 

Dcilti, lauding und guying (disk), 18-21 
Data, loading and saving (tape), 

18-21 
DATA statement, 92-94 118 
DEFine statement, 118 
Delay loop, 61, 65 
DELete key, 15 

DIMension statement, 118-119 
Division, 23, 26, 27, 113 
Duration, (see For . . . Next) 



Editing programs, 15, 34 

END statement, 1 1? 

Equal, not-equal-to, signs, 23, 26-27, 

1 14 
FquatJAnft, 1 1 4 

Error messages, 22-23, 150-151 
Expansion port, 141-142 
EXPonent function, 126 
Exponentiation, 25-27, 113 



Files, (DATASSETTE), 21, U0-111 
Files, (disk), 21, 110-111 
FOR statement, 1 19 
FRE fvndion, 129 
Function, 125-129 



Game controls and ports, 2-3, 141 

GET statement, 47-48, 119-120 

GET# statement, 120 

Getting started, 13-29 

GOSUB statement, 120 

GOTO (GO TO) statement. 32-34, 120 
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Graphic keys, 17, 56-57, 61, 132-137 
Graphic symbols, Isee graphic keys) 
Greater than, 1 1 + 

H 

Hyperbolic functions, 140 

I 

IEEE-488 Interface, 2-3, 141 

IF . . . THEN statement, 37-39, 120- 

121 
INPUT statement, 45-47, 121 
INPUT#, 121 
INScrt key, 15 
INTeger functicn, 126 
Integer variohle, 112 
I/O pinouts., 141-143 
I/O ports, 2-7, 141-143 



Joysticks, 2-3, 141 



Keyboard , 14-17 



LEFT! function, 128 

LENgth function, I2B 

Less than, 1 14 

LET statement, 12? 

LIST command, 33-34, 115 

LOAD command, 1 15 

LGADing programs an tape, 18-20 

LOGortthm function, 126 

Loop.,, 39-40, 43-45 

Lower case characters, 14-17 

M 

Mathematics 
formulas, 23-27 
Function table, 140 
symbols, 24-27, 38, 114 

Memory expansion, 2-4, 142 

Memory maps, 62-65 



MID$ function. 
Modulator, RF, 
Multiplication, 
Music, 79-90 


128 
4-7 
24, 113 


N 




Names 

program, 18-21 

variable, 34-37 
NEW command, 115 
NEXT statement, 121-122 



NOT operator, 1 14 
Numeric variobles, 36-37 



ON statcmunt, 122 
OPEN statement, 122 
Operators 

arithmetic, 1 13 
logical, 1 14 
relational, 114 



Parentheses, 28 
PEEK function, 60-62 

Peripherals, viii, 2-B, 107-109 

POKE statement, 60-61 

Ports, I/O, 2-3, 141-143 

POS function, 129 

PRINT statement, 23-29, 123-154 

PRINT#, 124 

Programs 

editing, 15, 34 

line numbering, 32-33 

loading/saving (DATA5SETTE), 18-21 

loading/saving (disk), 18-21 
Prompt, 45 



Quotation marks, 22 



RaNDc™ function, 48-53, 126 
Random numbers, 48-53 
READ statement, 7 24 
REMark statement, 124 
Reserved words, (see Command state- 
ments) 
Restore key, 15, 18 
RESTORE statement, 124 
Return key, 15, 18 
RETURN statement, 124 
RIGHTS function, 129 
RUN command, T16 
RUN/STOP key, 16-17 

S 

SAVE command, 21, 1 14 

Saving programs (DATASSETTE), 21 

Saving programs (disk), 23 

Screen memory maps, 62-43, 138 

SGN, function, 127 

Shift key, 14-15, 17 

SINe function, 127 

Sound effects, 89-90 

SPC function, 129 
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SPRITE EDITOR, vii, 69-76 

SPRITE graphics, vii, 69-76 

SQuaRe function, 127 

STOP command, 125 

STOP key, 16-17 

String variables, 36-37, 112-113 

STR$ function, 1 28 

Subscripted vartabks, 95-9B, 112-113 

Subtraction, 24, !13 
Syntax error, 22 
SYS statemcsit, 125 



TAB -Furction, 129 
TAN function, 127 
Tl variable, 1 13 
Tl$ variable, 1)3 
Time clock, 1 13 
TV connections, 3-7 

U 

Upper/Lower Case mode, 14 



USR function, 127 

User defined Function, (see DEF) 



VUue function, 123 
Variables 

array, V>5- 103, 1 1 3 

dimensions, 98-103, 113 
floating point, W-103, 113 

integer, 95-103, 112 
numeric, 95-103, 112 
string ($), 95-103, 112 

VERIFY eommond, 117 

\foice, 80-90, 162-164 

W 

WAIT command, 125 

Writing to tape, 110 



z 

Z-80, 



108 
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Commodore hopes you've enjoyed the COMMODORE 64 
USER'S GUIDE. Although this manual contains some pro- 
gramming information and tips, it is NOT intended to be a 
Programmer's Reference Manual. For those of you who are 
advanced programmers ond computer hobbyists Commo- 
dore suggests that you consider purchasing the COMMO- 
DORE 64 PROGRAMMER'S REFEKbNCE GUIDE available 
through your local Commodore dealer. 



n rtdHi+icin updates and eorrectons as well as programming hints end tips are available in 
-he COWMODORE end POWFR PLAY magazines, on the COMMODORE database of the 
COMPUSERVE INFOBMATION NETWORK, nccesseri through n VICAJWPFM 



COMMODORE 64 QUICK REFERENCE CARD 



SIMPLE VARIABLES 

yp* Fame Ranae- 
R w l XT = 1.701 Jl IB -JE + 36 

Integer XY^S 1 327*7 

5sr3r ly XYS l& 2S5 cbvwitn 

X i a titer (A-Z}, > " * l=H»f c number (0-S)- WriaWr n-imtt 

cm be mors ihafl 2 ehaxicitT, tot tnly fte firsp two cr* recoo' 

nazed. 

ARRAY WSIAHL15 



Type 


Jflurn* 


Single Dimi-flE-cn 


>r(ij 


"-■.-. -" ~~f !>.- 


XV(5^) 


Th^Kis-Dimtnsioii 


XYIDS&.9] 



Arqys of L p ft ili^A elerTemtS. {[utlKrian fl-lOT-Catf b* Uttd 

.v ;;r; (vestfe-d .. Atiroi .'.- rh nor* Than eleven elenums n^id ra 
b* DlfHBnibnHJ. 

ALGEREtAIC OPtRAJQRS 

■ Jk.ffignc unlm In. vnftihl* 
— Nejorrian 

■"* t^ponenriafiiMi 
■ AddifKjn 
R'EUMIOMAL ftMD U3h33i^L OPERATORS 

<> Mol Equal % 
C -»s.i Ihcn 

■=* SnuM ¥-,u.. 

< = 1*1* Thorn □■ Equal To 

> = C-reoter TSon or Equal To 

HOT Logical "HcH" 

AHE Ljqicul "And" 

OK Logical "Or" 

tisi-^isran equals 1 It rrue, 3 Jf false , 

SYSTEM COMMANDS 

HjAFJ 'HAHt" LOOC* Q p'&5'Om "&m rop* 

": -'. F "NAME" Nerval ■= :-c;-ot an 'ape 

LOAD "NAM£"^ Loads o (wo^'om from ditfc 
5JWE "NAME". 3 Wei O pre-gror-' rrj disk 
Vtftl-FY ''NAME" U*-r£*< AcH pwhnrrim -*ns SA'Ed 
wirhsu" *™0»5 

RUN EwtcuUs a pwigMrn 

&UH ~" EneeuHi* program *1-&r»l*g at in* 



s -or 


Hofli €«*cution 


END 


Endr c:**i.'jr<a'' 


CONT 


CotvinuBi program exec u'lan fron- 




hnt where program w?j hali*d 


rekgq 


R*lt*f» »■**»«**«* memory 




Ig^cAkin X 


POKEX.Y 


Changes C0Ft»nti of larti'iofl X 




lu *alu*Y 


5'fS HXXXX 


Jumps to i*eture fl fflatrme Icsngu 




program", smarting at x&jcjot 


ff«I K,T,S 


Prggram warn uiill confmi* of' 



iMOnflin. X, wfieri FQSed «"rth Z md 
ANDe-U wlih T, li !-o-it'3 
USllfK Faisc-i ■idlu* of X id u machhv 

langiKige subroutine 

EDITING AMD FOftWJJTlNG CCMMANCS 

Lf£f Lisil s c-fe- --ng-cm 

LIST rt-B LLtTi from Lire A to line 6 

KtV. Meisage Commcnl rile-slagc can St liJted But 

!i. iejaarad during crgram •^■EuTkin 

TAB(X) Uiad 4n PRIMT itatemenl!. Spm X 

pc.*l»ont -on tchhii 



SPCCX> 
POS(X) 
CLR/HOME 

SH!f : CLS. HQ'At 

SHIFT INST/DEL 

IWST^OEL 

CTRL 

C RSR Kttyi 

CommcKJore Key 



i'RMs K blanks on line 
fi^tirns rurmnl cursor pcairinrt 
PoirTions cuiUf 'b IfePt darn*r of 

i m wi 

Cl*>3rs lectin on^H pnrpi rur'.nr r> 

"Hsmt" pcsiriiiri 

IfiKrtj '-pact at cvrtinl cu'Sa-f 

DeE?(et chafQcrir ai currcnf :ursw 

pOlilrarl 

V,'--n ui-sd with nuni«rie iaF«r key, 

3*lfr£t* lext color. .May fc- vi(d In 

PRIST i' jieifien'. 

CT1 kTEtD 

',V'r.?n used- wiir. 2 H I - 1 le ec"i 

facTWCEP U 1 pptC",''lu'*VW t"JMT W'J 

graphic display mode. 

Whin used ^Fth nymerk color key, 

sf-l+ns opilcncl i«x.i calui 



ARRAT5 ^MDSTRMSS 



UN {X5) 

sresoQ 

WL(Xi) 
CHfi3{X] 
A6C*V») 

L:FJSiAS,i) 

RICHT5(A4,X|. 



SfffS masiirniiiri HtlirrTpH Ifor A; 

reserve* iixce br W + If(T-iril-t-l) 

flfmtnn HcrirnO Ol ftl.Cr r l> r 0I 
K«Kjmi nunr-be* of cncircctsn in ^i 
Baftjmc nijir^rir >.<i>iIip of X. 
cariverted 16 O , j"i''j 

Ret'jrm nunr,«ric vCiIle of AS, UJJ to 
fl-'«1 ■nannurrsr-c rdnrnttur 



ASCII chortitier irhriiw tode 



R*i 

BMhih ASCII cc^< 

: • -■ :i'v' of Xt 

fiefjnis lef**H)i1 X Gl»ctr5Cl(fn cf A| 



of At 

fi?l.i™ Y cheu-arren of AS 

siarai'j -in -rliurvilvr X 



INPUT O-UIFUT COfrtrAANt 

'JS1..1T AS on a f=; M" 1 ' 



1MPLJT "AiCA 
GtT AS 0' A 
DATA A/'fi'^.C 
HEAD Ai at A 

PRINT ,J A= lr ;A 



K-»»n Li "il ■■.■C-11 fsr 

U3*r TO enter a tlrinsg nr vcilvv 
PfiWTi m«SBd^# ond vrfifi Io-f uter 
M ««■ «(Ah. Com ■=> = =■ =nf_. " At 
iribiii Fur us*r te type era- 

charart.r V3 | UF . •» RETURN needed 
InHfllhMP o «■* of '«"luet rhi+ 

can be uied by REA.D sl3lemen« 
Assigns ne*i DATA yplyg tc. AS q- A 
■<<i!r _ i jl: _ ij pohler To \lcrr1 
BgADing th« DATA 1b1 ngcin 
FRIIMTi atfing r A= ' Q(kd waive o( A 
'-' iiuppr?si?s ipecet - '.' ■aas ssto 
10 lent field. 



PROGRAM FLOW 

GOTO X 

IF A=3 THEN 10 



fOft A= 1 TO 10 

STEP 2 : 4EKT 



r*EKT A 
50SU6 2000 



^N K GOTO A,B 
Dhl X GOSLTBi A. i 



Bronchss t-c lin-g X 

IF OHMtfafJ Is tiue THEN exectrte 

fc>lbwir.g p=r+ 5 f 31ot 4 m)nl. If 

fohe, tseeuie rext fne ^umaer 

Fnnr- L C= all sta:»mflnJi fcr!-,'.e*n FOE 

unJ tuiea-pnr'diriy HEK1, whh A 

g Ding from I to 10 by 3. Srep lize 

is 1 u-nless frpecKfied 

DcrTncs tnc sf oup A Is rjpilgnnl 

Bronchi* le njfcrciurne ft-artrifl «t 

line 20W 
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ABOUT THE COMMODORE 64 
USER'S GUIDE . . * 



Outstanding color . , . sound synthesis , , . graphics . . ■ 
computing capabilities ... the synergistic marriage of 
state-of-the-art technologies. These features make the 
Commodore 64 the most advanced personal computer 
in its class. 

The Commodore 64 User's Guide helps you get started 
in computing, even if you've never used a computer 
before. Through clear, step-by-step instructions, you 
are given an insight into the BA5IC language and now 
the Commodore 64 can be put to a myriad of uses. 

For those already familiar with microcomputers, the 
advanced programming sections and appendices 
explain the enhanced features of the Commodore 64 
and how to get the most of these expanded 
capabilities. 
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